void* pblIteratorPrevious

( PblIterator* iterator )

Returns the previous element in the iteration.

Documentation

Returns the previous element in the iteration.

This method may be called repeatedly to iterate through the list backwards, or intermixed with calls to next to go back and forth. (Note that alternating calls to next and previous will return the same element repeatedly.)

This method has a time complexity of O(1).

Parameters:

iterator - The iterator to return the previous element for

Returns:

void * retptr != (void*)-1: The previous element in the iteration. May be NULL.
void * retptr == (void*)-1: An error, see pbl_errno:
PBL_ERROR_NOT_FOUND - The iteration has no more elements.
PBL_ERROR_CONCURRENT_MODIFICATION - The underlying collection was modified concurrently.

Alphabetic index