pub unsafe extern "C" fn qmap_get_multi(
hd: u32,
key: *const c_void,
) -> u32Expand description
@brief Start iteration over all values for a key.
For maps with QM_MULTIVALUE flag, this returns a cursor that iterates over ALL values associated with the given key in sorted order. For maps without QM_MULTIVALUE, this behaves like a single-value iterator.
@param[in] hd Map handle. @param[in] key Key to look up. @return Cursor handle for use with qmap_next(), or QM_MISS if key not found.
Example: @code uint32_t cur = qmap_get_multi(hd, &key); if (cur != QM_MISS) { const void *k, *v; while (qmap_next(&k, &v, cur)) { // Process each value for this key } qmap_fin(cur); } @endcode
@note Internally, this is equivalent to: qmap_iter(hd, key, 0) @note For single-value lookups, qmap_get() is more efficient @see qmap_del_all for deleting all duplicates at once @see qmap_count for counting entries without iteration