Referência ao ficheiro src/vapiLists.c

#include <stdio.h>
#include "vapiLists.h"
#include "vapiMacro.h"

Diagrama de dependências de inclusão para vapiLists.c:

Ir para o código fonte deste ficheiro.

Funções
void	v_list_append (vList *List, vpointer data)
	adds an item to the end of the list.
int	v_list_count_elements (vList *List)
	count how many elements the list has.
int	v_list_count_elements_aux (vList *List, int start)
void	v_list_delete_item (vList *List, vFreeFunction FreeFunction, int Delete)
	deletes the item
static void	v_list_delete_item_aux (vList *List, vList *Previous, vFreeFunction FreeFunction, int Delete, int Start)
void	v_list_free (vList *List, vFreeFunction FreeFunction)
	Frees the entire list. This is called when we want a list to fre totally freed.
vpointer	v_list_get (vList *List, int Item)
	gets the data for the item in that position in the list.
static vpointer	v_list_get_aux (vList *List, int Item, int Start)
void	v_list_insert (vList *List, vpointer data, int position)
	Insert an element on the list, in the desired position.
static void	v_list_insert_aux (vList *List, vList *Previous, vpointer data, int position, int Start)
void	v_list_move (vList *List, int source, int destination)
	moves an item from one source to a destination
vList *	v_list_new ()
	creates an empty list

---

Documentação das funções

void v_list_append	(	vList *	List,
		vpointer	Data
	)

adds an item to the end of the list.

Parâmetros:

	List	The list to append the item
	Data	The data to store in the item.

Definido na linha 14 do ficheiro vapiLists.c.

Referências List e v_list_append().

Referenciado por v_bypass_append(), v_list_append(), vapiGroupListAddItem(), vapiGtkMacroItemMoveDown(), vapiGtkMacroItemMoveToBottom(), vapiIOListAddIO(), vapiIOListConfiguredAdd(), vapiMacroAddItem(), vapiMacroListAddItem() e vapiOperationListAddItem().

{

        if (*List == NULL)
        {
                *List = malloc (sizeof (vListItem));
                (*List)->data = data;
                (**List).Next = NULL;
        }
        else
        {

                v_list_append ((vList *) & (**List).Next, data);
        }

}

Grafo de chamadas desta função:

Here is the caller graph for this function:

int v_list_count_elements

(

vList *

List

)

count how many elements the list has.

Retorna:

the number of elements of the list.

Definido na linha 46 do ficheiro vapiLists.c.

Referências List e v_list_count_elements_aux().

Referenciado por v_bypass_reload(), v_bypass_search(), v_list_free(), v_list_insert(), v_stopby_set(), vapiGroupListCountElements(), vapiGtkMacroTable(), vapiGtkMacroTableAux(), vapiGtkWindowIOAddInitIOList(), vapiGtkWindowIOAddPopulateGroup(), vapiGtkWindowIOConfiguredList(), vapiIOConfiguredToXML(), vapiIOListAddGroup(), vapiIOListAddIO(), vapiIOListCount(), vapiIOListSelect(), vapiIOListSelectN(), vapiMacroCountElements(), vapiMacroGetMacroIndex(), vapiMacroListCountElements(), vapiOperationListCountElements() e vIOCheckList().

{
        if ((*List) == NULL)
        {
                return 0;
        }
        return v_list_count_elements_aux (List, 0);
}

Grafo de chamadas desta função:

Here is the caller graph for this function:

int v_list_count_elements_aux	(	vList *	List,
		int	start
	)

Definido na linha 32 do ficheiro vapiLists.c.

Referenciado por v_list_count_elements().

{
        start = start + 1;

        if ((**List).Next != NULL)
        {
                start = v_list_count_elements_aux ((vList *) & (**List).
                                                   Next, start);
        }

        return start;
}

Here is the caller graph for this function:

void v_list_delete_item	(	vList *	List,
		vFreeFunction	FreeFunction,
		int	Delete
	)

deletes the item

Parâmetros:

	Delete	the number of the item to delete in the list.
	FreeFunction	the functions that frees the data. If NULL is passed, the data is not freed.

Definido na linha 120 do ficheiro vapiLists.c.

Referências List e v_list_delete_item_aux().

Referenciado por v_list_free(), v_list_move(), vapiGtkMacroItemMoveDown(), vapiGtkMacroItemMoveToBottom(), vapiGtkMacroItemMoveToTop(), vapiGtkMacroItemMoveUp(), vapiIOConfiguredDelete(), vapiMacroDeleteItem() e vapiMacroListDeleteItem().

{
        v_list_delete_item_aux (List, NULL, FreeFunction, Delete, 0);
}

Grafo de chamadas desta função:

Here is the caller graph for this function:

static void v_list_delete_item_aux	(	vList *	List,
		vList *	Previous,
		vFreeFunction	FreeFunction,
		int	Delete,
		int	Start
	)			[static]

Definido na linha 56 do ficheiro vapiLists.c.

Referências List e _vListItem::Next.

Referenciado por v_list_delete_item().

{
        vList *Temp;
        if (*List == NULL)
        {
                return;
        }

        if (Start == Delete)

        {


                if ((**List).Next != NULL)
                {
                        if (Previous == NULL)
                        {
                                Temp = (vList *) & (**List).Next;
                                if (FreeFunction != NULL)
                                {
                                        FreeFunction ((*List)->data);
                                }
                                (*List)->data = (*Temp)->data;
                                (*List)->Next =
                                        (struct vListItem *) (*Temp)->Next;
                                //free(Temp);

                        }
                        else
                        {

                                (*Previous)->Next = (*List)->Next;
                                //FreeFunction ((*List)->data);
                                //free ((*List));


                        }
                }

                else
                {
                        if (FreeFunction != NULL)
                        {
                                FreeFunction ((*List)->data);
                        }
                        free (*List);
                        *List = NULL;
                }

                return;
        }
        if ((**List).Next != NULL)
        {
                Start++;
                v_list_delete_item_aux ((vList *) & (*List)->Next,
                                        (vList *) List, FreeFunction, Delete,
                                        Start);
        }


}

Here is the caller graph for this function:

void v_list_free	(	vList *	List,
		vFreeFunction	FreeFunction
	)

Frees the entire list. This is called when we want a list to fre totally freed.

Parâmetros:

FreeFunction

the functions that frees the data. If NULL is passed, the data is not freed.

Definido na linha 212 do ficheiro vapiLists.c.

Referências List, v_list_count_elements() e v_list_delete_item().

Referenciado por v_bypass_clean() e vapiMacroDelete().

{
        int Count, i;

        Count = v_list_count_elements (List);

        /*
         * Caso existam items, eliminá-los.
         */
        if (Count > 0)
        {
                for (i = Count; i > 0; i--)
                {

                        v_list_delete_item (List, FreeFunction, (i - 1));

                }
        }
        free(List);
}

Grafo de chamadas desta função:

Here is the caller graph for this function:

vpointer v_list_get	(	vList *	List,
		int	Item
	)

gets the data for the item in that position in the list.

Parâmetros:

Item

the number of the item

Retorna:

The pointer for the data

Aviso:

The returned pointer should not be freed.

Definido na linha 152 do ficheiro vapiLists.c.

Referências List e v_list_get_aux().

Referenciado por v_bypass_search(), v_input_NULL_boolean(), v_input_str_int(), v_list_move(), v_stopby_set(), vapiGroupListSelectGroup(), vapiGroupListSelectItem(), vapiGtkMacroItemMoveDown(), vapiGtkMacroItemMoveToBottom(), vapiGtkMacroItemMoveToTop(), vapiGtkMacroItemMoveUp(), vapiGtkWindowIOAdd_Add(), vapiGtkWindowIOAddInitIOList(), vapiGtkWindowIOAddPopulateGroup(), vapiGtkWindowIOAddSelectIO(), vapiGtkWindowIOAddShowDescription(), vapiGtkWindowIOConfiguredList(), vapiGtkWindowIOConfiguredSaveChanges(), vapiGtkWindowIOConfiguredSelect(), vapiIOConfiguredToXML(), vapiIOListAddGroup(), vapiIOListSelect(), vapiIOListSelectN(), vapiIOPropertySetChar(), vapiIOPropertySetInt(), vapiMacroGetMacroIndex(), vapiMacroListSelectItem(), vapiMacroSelectItem(), vapiOperationListSelectItem() e vapiOperationListSelectOperation().

{
        return (v_list_get_aux (List, Item, 0));
}

Grafo de chamadas desta função:

Here is the caller graph for this function:

static vpointer v_list_get_aux	(	vList *	List,
		int	Item,
		int	Start
	)			[static]

Definido na linha 126 do ficheiro vapiLists.c.

Referências List.

Referenciado por v_list_get().

{

        if (*List == NULL)
        {
                return NULL;
        }

        if (Start == Item)
        {
                return (*List)->data;

        }
        if (&(**List).Next != NULL)
        {
                Start++;
                return (v_list_get_aux
                        ((vList *) & (**List).Next, Item, Start));
        }
        else
        {
                return NULL;
        }
}

Here is the caller graph for this function:

void v_list_insert	(	vList *	List,
		vpointer	data,
		int	position
	)

Insert an element on the list, in the desired position.

Parâmetros:

position

the item will be add in the position

Definido na linha 192 do ficheiro vapiLists.c.

Referências List, v_list_count_elements() e v_list_insert_aux().

Referenciado por v_list_move(), vapiGtkMacroItemMoveDown(), vapiGtkMacroItemMoveToTop(), vapiGtkMacroItemMoveUp() e vapiMacroAddItemPositioned().

{
        int ListSize;
        
        ListSize = v_list_count_elements(List);
        /*
         * Verificação da posição dentros dos limites da lista.
         */
        if (position <0 || position >=ListSize)
        {
                return;
        }
        /*
         * O que se pretende é ir à posição anterior e 
         *  adicionar o Operation seguinte. 
         */
        v_list_insert_aux ((vList *) & (**List).Next, List, data, position, 0);
}

Grafo de chamadas desta função:

Here is the caller graph for this function:

static void v_list_insert_aux	(	vList *	List,
		vList *	Previous,
		vpointer	data,
		int	position,
		int	Start
	)			[static]

Definido na linha 160 do ficheiro vapiLists.c.

Referências _vListItem::data, List e _vListItem::Next.

Referenciado por v_list_insert().

{
        vListItem *NewItem;


        if (Start == position)
        {

                NewItem = malloc (sizeof (vListItem));
                NewItem->data = data;
                NewItem->Next = (struct vListItem *) (*Previous);
                (*Previous) = NewItem;

                return;

        }
        if (*List == NULL)
        {
                return;
        }
        else
        {
                Start++;
                v_list_insert_aux ((vList *) & (**List).Next,
                                List, data, position, Start);
        }



}

Here is the caller graph for this function:

void v_list_move	(	vList *	List,
		int	source,
		int	destination
	)

moves an item from one source to a destination

Parâmetros:

	source	the source position
	destination	the destination position

Definido na linha 233 do ficheiro vapiLists.c.

Referências List, v_list_delete_item(), v_list_get() e v_list_insert().

{
        vpointer * Item;
        Item = v_list_get(List, source);
        
        v_list_delete_item (List, NULL, source);
        
        if (source < destination)
        {
                destination--;
        }
        
        v_list_insert(List, Item, destination);
        
}

Grafo de chamadas desta função:

vList * v_list_new

(

)

creates an empty list

Definido na linha 6 do ficheiro vapiLists.c.

Referências List.

Referenciado por v_bypass_init(), vapiGroupListNew(), vapiIOListConfiguredNew(), vapiIOListNew(), vapiMacroListNew() e vapiOperationListNew().

{
        vList *List = malloc (sizeof (vList));
        *List = NULL;
        return List;
}

Here is the caller graph for this function:

---