ListInsertValueBeforeIterByValue()

EXTERN_C bool Chusov::ListInsertValueBeforeIterByValue ( HCHSVLISTITERATOR  hListIterator, void *  lpData, std::size_t  nDataSize  )

noexcept

Creates a new list element to the position before the one specified by the iterator copying the specified content to the internal buffers.

Parameters

hListIterator	is a handle to the iterator defining position after the insertion position.
lpData	is a pointer to data copied as the element data.
nDataSize	is a byte size of the data copied to the new element buffer.

Returns

true on success, false on failure.

Remarks

The list is not thread-safe.

The functions like ListPushBackValueByValue(), ListPushFrontValueByValue(), ListInsertValueAfterIterByValue(), ListInsertValueBeforeIterByValue() or ListIterSetValueByValue() perform per byte copying to the new element's internal buffers. This may not be applicable to the C++ objects.

Declared in chsvlist.h.

See also

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