void* pblSetTail

( PblSet* set )

Retrieves, but does not remove, the tail (last element) of this set.

Documentation

Retrieves, but does not remove, the tail (last element) of this set.

For hash sets accessing an element at the end 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 end 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 last element of the set.
void * retptr == NULL: An error, see pbl_errno:
PBL_ERROR_OUT_OF_BOUNDS - This set is empty.

Alphabetic index