ListInsertValueBeforeIterByPtr()

EXTERN_C bool Chusov::ListInsertValueBeforeIterByPtr ( HCHSVLISTITERATOR  hListIterator, void *  lpData  )

noexcept

Creates a new list element with by-pointer insertion to the position before the one specified by the iterator.

Parameters

hListIterator	is a handle to the iterator defining position after the insertion position.
lpData	is a pointer to be written as data of the new element. Content specified by the pointer is ignored.

Returns

true on success, false on failure.

Remarks

The list is not thread-safe.

The functions like ListPushBackValueByPtr(), ListPushFrontValueByPtr(), ListInsertValueBeforeIterByPtr(), ListInsertValueAfterIterByPtr() or ListIterSetValueByPtr() perform insertions of only pointers without physical copying of the pointed data. The data itself is ignored by the functions. The size of the data of the inserted elements will be zero, therefore for such elements zero length will be returned by the functions like ListGetDataSizeFromIter().

Declared in chsvlist.h.

See also

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