void* pblListRemoveFirst

( PblList* list )

Removes and returns the first element in this list.

Documentation

Removes and returns the first element in this list.

For array lists this method has a time complexity of O(N), with N being the size of the list.

For linked lists this method has a time complexity of O(1).

Parameters:

list - The list to use

Returns:

void * retptr != (void*)-1: The first element in this list, may be NULL.
void * retptr == (void*)-1: An error, see pbl_errno:
PBL_ERROR_OUT_OF_BOUNDS - this list is empty.

Alphabetic index