ListIterNext()

EXTERN_C HCHSVLISTITERATOR Chusov::ListIterNext ( HCHSVLISTITERATOR  hListIterator )

noexcept

Returns a handle to the iterator bound with the element located after the element bound with the specified iterator.

Parameters

hListIterator

is a handle to the element located before the required one.

Returns

On success the function returns a handle to the iterator bound with the element located after the element of the specified iterator.
If the hListIterator accords to the last element of the list the function returns LIST_ITERATOR_DOES_NOT_EXIST (NULL).
If any other error occurs the function returns LIST_ITERATOR_ERROR ((HCHSVLISTITERATOR) -1).

Remarks

The list is not thread-safe.

The returned handle to the iterator does not need to be closed.

Declared in chsvlist.h.

See also

ListBegin();
ListEnd();
ListIterPrev().