Unilayer Static Lists

Collaboration diagram for Unilayer Static Lists:

Macros
#define	LIST_ERROR_MAX   -100
#define	dio_list_append(node, list, list_sz, list_max, list_type)
	Append a copy of the given node to the end of a static list.
#define	dio_list_remove(idx, list, list_sz, list_type)   assert( (idx) < (list_sz) ); while( (idx) + 1 < (list_sz) ) { memory_copy_ptr( (MEMORY_PTR)&(list[idx]), (MEMORY_PTR)&(list[idx + 1]), sizeof( list_type ) ); (idx)++; } (list_sz)--;
	Remove an item from a static list and move the other items up, then shrink the list.

Detailed Description

Macro Definition Documentation

dio_list_append

#define dio_list_append	(		node,
			list,
			list_sz,
			list_max,
			list_type
	)

Value:

   if( (list_sz) + 1 >= (list_max) ) { \
      g_dio_error = LIST_ERROR_MAX; \
   } else { \
      memory_copy_ptr( (MEMORY_PTR)&(list[list_sz]), (MEMORY_PTR)node, \
         sizeof( list_type ) ); \
      (list_sz)++; \
   }

Append a copy of the given node to the end of a static list.

Parameters

node	Locked MEMORY_PTR to a node to copy to the end of the list.
list	Locked MEMORY_PTR to the list to manipulate.
list_sz	Number of active items in the list.
list_max	Maximum number of active items the list can hold.
list_type	Type of items in the list.

dio_list_remove

#define dio_list_remove	(		idx,
			list,
			list_sz,
			list_type
	)		assert( (idx) < (list_sz) ); while( (idx) + 1 < (list_sz) ) { memory_copy_ptr( (MEMORY_PTR)&(list[idx]), (MEMORY_PTR)&(list[idx + 1]), sizeof( list_type ) ); (idx)++; } (list_sz)--;

Remove an item from a static list and move the other items up, then shrink the list.

Parameters

idx	Index of the item to remove.
list	Locked MEMORY_PTR to the list to manipulate.
list_sz	Number of active items in the list.
list_type	Type of items in the list.