MapGetFirstPtr

Documentation

API Reference

MapGetFirstPtr

Description

Get pointer to the first value stored for a key.

Parameters

Name	Direction	Description
`m`	in,out	Map.
`lookup_key`	in	Key to search for.

Success

Returns a pointer of type MAP_VALUE_TYPE(m) * to the value slot of the first matching entry. The map is not modified. The pointer is valid until the next rehash.

Failure

Returns NULL when no entry exists for the key. The map is not modified.

Usage example (Cross-references)

Usage examples (Cross-references)

In Debug.c:313:

            return 0;
    
        DebugRecord *live_rec = MapGetFirstPtr(&self->live, ptr);
    
        if (!live_rec) {

In Debug.c:434:

        // the copy. If ptr is not in the live map, forward to deallocate
        // which emits the double-free / foreign-ptr diagnostic and aborts.
        DebugRecord *rec = MapGetFirstPtr(&self->live, ptr);
        if (!rec) {
            debug_allocator_deallocate(self, ptr); // aborts

In KvConfig.c:338:

            return NULL;
        }
        return MapGetFirstPtr(cfg, *key);
    }

In Map.Insert.c:36:

        result      = result && (MapValueCountForKey(&map, 2) == 1);
        result      = result && (MapValueCountForKey(&map, 3) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 10);
        result      = result && MapGetFirstPtr(&map, 2) && (*MapGetFirstPtr(&map, 2) == 200);
        result      = result && MapGetFirstPtr(&map, 3) && (*MapGetFirstPtr(&map, 3) == 30);

In Map.Insert.c:37:

        result      = result && (MapValueCountForKey(&map, 3) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 10);
        result      = result && MapGetFirstPtr(&map, 2) && (*MapGetFirstPtr(&map, 2) == 200);
        result      = result && MapGetFirstPtr(&map, 3) && (*MapGetFirstPtr(&map, 3) == 30);

In Map.Insert.c:38:

        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 10);
        result      = result && MapGetFirstPtr(&map, 2) && (*MapGetFirstPtr(&map, 2) == 200);
        result      = result && MapGetFirstPtr(&map, 3) && (*MapGetFirstPtr(&map, 3) == 30);
    
        MapDeinit(&map);

In Map.Insert.c:57:

        bool result = (MapPairCount(&map) == 3);
        result      = result && (MapValueCountForKey(&map, 1) == 3);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 100);
        result      = result && MapContainsPair(&map, 1, 11);
        result      = result && MapContainsPair(&map, 1, 12);

In Map.Insert.c:78:

        bool result = (key == 0) && (value == 0);
        result      = result && (MapValueCountForKey(&map, 42) == 1);
        result      = result && MapGetFirstPtr(&map, 42) && (*MapGetFirstPtr(&map, 42) == 84);
    
        MapDeinit(&map);

In Float.Compare.c:207:

    
        Float probe   = FloatFromStr("314e-2", &alloc.base); // same value as k1
        u64  *got     = MapGetFirstPtr(&counts, probe);
        Float missing = FloatFromStr("9.99", &alloc.base);
        u64  *gone    = MapGetFirstPtr(&counts, missing);

In Float.Compare.c:209:

        u64  *got     = MapGetFirstPtr(&counts, probe);
        Float missing = FloatFromStr("9.99", &alloc.base);
        u64  *gone    = MapGetFirstPtr(&counts, missing);
    
        bool result = (got != NULL && *got == 1u);

In AllocDebug.c:155:

        // to DebugAllocator with no public accessor; reach in to confirm the
        // alloc-trace was captured.
        DebugRecord *rec = MapGetFirstPtr(&dbg.live, p);
        ok               = ok && (rec != NULL) && (rec->alloc_trace_n > 0);

In Map.Remove.c:33:

        result      = result && MapContainsKey(&map, 1);
        result      = result && (MapValueCountForKey(&map, 1) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 11);
        result      = result && (MapPairCount(&map) == 2);

In Map.Remove.c:80:

        result      = result && !MapContainsKey(&map, 2);
        result      = result && (MapValueCountForKey(&map, 1) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 11);
        result      = result && MapContainsKey(&map, 3);
        result      = result && (MapPairCount(&map) == 2);

In Map.Remove.c:124:

        bool result = !MapContainsKey(&map, 5);
        result      = result && MapContainsKey(&map, 105);
        result      = result && MapGetFirstPtr(&map, 105) && (*MapGetFirstPtr(&map, 105) == 205);
    
        MapDeinit(&map);

In Int.Compare.c:166:

    
        Int  probe   = IntFrom(100u, &alloc.base);
        u64 *got     = MapGetFirstPtr(&counts, probe);
        Int  missing = IntFrom(999u, &alloc.base);
        u64 *gone    = MapGetFirstPtr(&counts, missing);

In Int.Compare.c:168:

        u64 *got     = MapGetFirstPtr(&counts, probe);
        Int  missing = IntFrom(999u, &alloc.base);
        u64 *gone    = MapGetFirstPtr(&counts, missing);
    
        bool result = (got != NULL && *got == 1u);

In Map.Access.c:54:

        MapInsertR(&map, 11, 111);
    
        int *value  = MapGetFirstPtr(&map, 11);
        bool result = value && (*value == 110);
        result      = result && (MapGetFirstPtr(&map, 999) == NULL);

In Map.Access.c:56:

        int *value  = MapGetFirstPtr(&map, 11);
        bool result = value && (*value == 110);
        result      = result && (MapGetFirstPtr(&map, 999) == NULL);
    
        MapDeinit(&map);

In Map.Access.c:71:

        MapInsertR(&map, 11, 111);
    
        int *value  = MapGetFirstPtr(&map, 11);
        bool result = value && (*value == 110);
        result      = result && (MapGetFirstPtr(&map, 999) == NULL);

In Map.Access.c:73:

        int *value  = MapGetFirstPtr(&map, 11);
        bool result = value && (*value == 110);
        result      = result && (MapGetFirstPtr(&map, 999) == NULL);
    
        MapDeinit(&map);

In Map.Access.c:155:

        bool result = (MapValuePtrFromCursor(&map, cursor) == NULL);
        result      = result && (MapValueCountForKey(&map, 5) == 1);
        result      = result && MapGetFirstPtr(&map, 5) && (*MapGetFirstPtr(&map, 5) == 51);
    
        MapDeinit(&map);

In Map.Init.c:73:

        MapSetOnlyR(&map, 7, 70);
        result = result && (MapPairCount(&map) == 1) && (MapValueCountForKey(&map, 7) == 1);
        result = result && MapGetFirstPtr(&map, 7) && (*MapGetFirstPtr(&map, 7) == 70);
    
        MapDeinit(&map);

In Map.Init.c:97:

    
        for (int i = 0; i < 24; i++) {
            int *value = MapGetFirstPtr(&map, i);
            result     = result && value && (*value == i * 10);
        }

In Map.Init.c:128:

    
        for (int i = 0; i < 6; i++) {
            int *value = MapGetFirstPtr(&map, i);
            result     = result && value && (*value == (i + 100));
        }

In Graph.Foreach.c:66:

    
    static bool city_reachable(CityGraph *graph, CityIndex *index, const Str *from, const Str *to) {
        GraphNodeId *from_id = MapGetFirstPtr(index, *from);
        GraphNodeId *to_id   = MapGetFirstPtr(index, *to);

In Graph.Foreach.c:67:

    static bool city_reachable(CityGraph *graph, CityIndex *index, const Str *from, const Str *to) {
        GraphNodeId *from_id = MapGetFirstPtr(index, *from);
        GraphNodeId *to_id   = MapGetFirstPtr(index, *to);
    
        if (!from_id || !to_id) {

In Graph.Foreach.c:159:

        }
    
        bool result = *MapGetFirstPtr(&counts, a) == 0;
        result      = result && *MapGetFirstPtr(&counts, b) == 1;
        result      = result && *MapGetFirstPtr(&counts, c) == 1;

In Graph.Foreach.c:160:

    
        bool result = *MapGetFirstPtr(&counts, a) == 0;
        result      = result && *MapGetFirstPtr(&counts, b) == 1;
        result      = result && *MapGetFirstPtr(&counts, c) == 1;
        result      = result && *MapGetFirstPtr(&counts, d) == 2;

In Graph.Foreach.c:161:

        bool result = *MapGetFirstPtr(&counts, a) == 0;
        result      = result && *MapGetFirstPtr(&counts, b) == 1;
        result      = result && *MapGetFirstPtr(&counts, c) == 1;
        result      = result && *MapGetFirstPtr(&counts, d) == 2;

In Graph.Foreach.c:162:

        result      = result && *MapGetFirstPtr(&counts, b) == 1;
        result      = result && *MapGetFirstPtr(&counts, c) == 1;
        result      = result && *MapGetFirstPtr(&counts, d) == 2;
    
        MapDeinit(&counts);

In BitVec.Compare.c:1047:

        BitVecPush(&probe, true);
    
        u64 *got = MapGetFirstPtr(&counts, probe);
    
        BitVec missing = BitVecInit(base);

In BitVec.Compare.c:1052:

        BitVecPush(&missing, true);
        BitVecPush(&missing, true);
        u64 *gone = MapGetFirstPtr(&counts, missing);
    
        bool result = (got != NULL && *got == 1u);

In Map.Ops.c:56:

        result       = result && !MapContainsKey(&map, key);
        result       = result && (MapValueCountForKey(&map, "alpha") == 2);
        stored_value = MapGetFirstPtr(&map, "alpha");
        result       = result && stored_value && (*stored_value != value) && (ZstrCompare(*stored_value, "first") == 0);
        MapForeachValueForKey(&map, "alpha", entry_value) {

In Map.Ops.c:96:

                      (MapPolicy(&map).should_rehash == MapPolicyQuadratic.should_rehash);
        result = result && (MapValueCountForKey(&map, "red") == 2);
        result = result && MapGetFirstPtr(&map, "red") && (ZstrCompare(*MapGetFirstPtr(&map, "red"), "apple") == 0);
        result = result && MapGetFirstPtr(&map, "yellow") && (ZstrCompare(*MapGetFirstPtr(&map, "yellow"), "banana") == 0);
        result = result && MapGetFirstPtr(&map, "green") && (ZstrCompare(*MapGetFirstPtr(&map, "green"), "pear") == 0);

In Map.Ops.c:97:

        result = result && (MapValueCountForKey(&map, "red") == 2);
        result = result && MapGetFirstPtr(&map, "red") && (ZstrCompare(*MapGetFirstPtr(&map, "red"), "apple") == 0);
        result = result && MapGetFirstPtr(&map, "yellow") && (ZstrCompare(*MapGetFirstPtr(&map, "yellow"), "banana") == 0);
        result = result && MapGetFirstPtr(&map, "green") && (ZstrCompare(*MapGetFirstPtr(&map, "green"), "pear") == 0);
        MapForeachValueForKey(&map, "red", red_value) {

In Map.Ops.c:98:

        result = result && MapGetFirstPtr(&map, "red") && (ZstrCompare(*MapGetFirstPtr(&map, "red"), "apple") == 0);
        result = result && MapGetFirstPtr(&map, "yellow") && (ZstrCompare(*MapGetFirstPtr(&map, "yellow"), "banana") == 0);
        result = result && MapGetFirstPtr(&map, "green") && (ZstrCompare(*MapGetFirstPtr(&map, "green"), "pear") == 0);
        MapForeachValueForKey(&map, "red", red_value) {
            if ((ZstrCompare(red_value, "apple") == 0) || (ZstrCompare(red_value, "cherry") == 0)) {

Last updated on June 4, 2026

MapForeachValuePtrForKey MapGetOrDefault