Evas_List_General_Group (3) - Linux Manuals

Evas_List_General_Group: Miscellaneous functions that work on linked lists.

NAME

Linked List General Functions - Miscellaneous functions that work on linked lists.

Functions

EAPI void * evas_list_data (const Evas_List *list)
Get the list node data member.
EAPI int evas_list_count (const Evas_List *list)
Get the count of the number of items in a list.
EAPI int evas_list_alloc_error (void)
Return the memory allocation failure flag after any operation needin allocation.

Detailed Description

Miscellaneous functions that work on linked lists.

Function Documentation

EAPI int evas_list_alloc_error (void)

Return the memory allocation failure flag after any operation needin allocation.

Returns:

The state of the allocation flag

This function returns the state of the memory allocation flag. This flag is set if memory allocations during evas_list_append(), evas_list_prepend(), evas_list_append_relative(), or evas_list_prepend_relative() fail. If they do fail, 1 will be returned, otherwise 0 will be returned. The flag will remain in its current state until the next call that requires allocation is called, and is then reset.

Example:

 Evas_List *list = NULL;
 extern void *my_data;

 list = evas_list_append(list, my_data);
 if (evas_list_alloc_error())
   {
     fprintf(stderr, 'ERROR: Memory is low. List allocation failed.);
     exit(-1);
   }

EAPI int evas_list_count (const Evas_List * list)

Get the count of the number of items in a list.

Parameters:

list The list whose count to return

Returns:

The number of members in the list list

This function returns how many members in the specified list: list. If the list is empty (NULL), 0 is returned.

NB: This is an order-1 operation and takes the same tiem regardless of the length of the list.

Example:

 extern Evas_List *list;

 printf('The list has %i members, evas_list_count(list));

References _Evas_List::accounting.

EAPI void* evas_list_data (const Evas_List * list)

Get the list node data member.

Parameters:

list The list node to get the data member of

Returns:

The data member from the list node list

This function returns the data member of the specified list node list. It is equivalent to list->data.

Example:

 extern Evas_List *list;
 Evas_List *l;

 printf('The list:);
 for (l = list; l; l = evas_list_next(l))
   {
     printf('%p, evas_list_data(l));
   }

References _Evas_List::data.

Author

Generated automatically by Doxygen for Evas from the source code.