MapFindNextForKey

Description

Advance a per-key cursor to the next value for the same key.

Parameters

Success

Returns a MapValueCursor positioned at the next entry for lookup_key (in iteration order). The map is not modified.

Failure

Returns MapValueCursorInvalid() when no more entries match. The map is not modified.

Usage example (Cross-references)

            value_sum += *value_ptr;
            seen      += 1;
            cursor     = MapFindNextForKey(&map, 4, cursor);
        }