void* pblIteratorSet

( PblIterator* iterator, void* element )

Replaces in the underlying list the last element returned by next or previous with the specified element.

Documentation

Replaces in the underlying list the last element returned by next or previous with the specified element.

This call can be made only if neither pblIteratorRemove() nor pblIteratorAdd() have been called after the last call to next or previous.

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

Parameters:

iterator - The iterator to replace the element of.
element - Element with which to replace the last element returned by next or previous.

Returns:

void * retptr != (void*)-1: The element replaced, may be NULL.
void * retptr == (void*)-1: An error, see pbl_errno:
PBL_ERROR_NOT_ALLOWED - Neither the next nor previous have been called, or remove or add have been called after the last call to next or previous.
PBL_ERROR_CONCURRENT_MODIFICATION - The underlying list was modified concurrently.
PBL_ERROR_PARAM_LIST - The underlying collection is not a list.

Alphabetic index