MapGetDataSizeFromIter()

EXTERN_C std:: size_t Chusov::MapGetDataSizeFromIter ( HCHSVMAPITERATOR  hMapIter )

noexcept

The function returns a length, in bytes, of value data of the specified element inserted by value (with copying) or zero if the element has been inserted by pointer.

Parameters

[in]

hMapIter

is a handle to the iterator bound with the specified element.

Returns

The function returns a size, in bytes, of the value data stored in the internal buffers of the element. That is non-zero size for elements inserted by value and zero size for elements inserted by pointer. If the function fails it returns (size_t) -1. Use GetLastChsvError to get extended error information.

Remarks

The value data itself can be retrieved by a separate call to the MapGetDataFromIter function over the same iterator.

The complexity is \(O(1)\).

Declared in chsvmap.h.

See also

MapGetKeyFromIter;
MapGetKeySizeFromIter;
MapGetDataFromIter.