void* pblSetGetFirst

( PblSet* set )

Returns the first element in this set.

Documentation

Returns the first element in this set.

For hash sets accessing an element at the start of the set has a time complexity of O(N), with N being the capacity of the set.

For tree sets accessing an element at the start of the set has a time complexity of O(Log N), with N being the number of elements in the set.

Parameters:

set - The set to use

Returns:

void * retptr != NULL: The first element of the set.
void * retptr == NULL: An error, see pbl_errno:
PBL_ERROR_OUT_OF_BOUNDS - This set is empty.

Alphabetic index