MapContainsKey

Documentation

API Reference

MapContainsKey

Description

Check if the map stores at least one value for a key.

Parameters

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

Success

Returns true when at least one entry exists for the key. The map is not modified.

Failure

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

Usage example (Cross-references)

Usage examples (Cross-references)

In Map.Remove.c:31:

    
        bool result = MapRemoveFirst(&map, 1);
        result      = result && MapContainsKey(&map, 1);
        result      = result && (MapValueCountForKey(&map, 1) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 11);

In Map.Remove.c:78:

    
        bool result = (MapRemoveIf(&map, remove_even_values, NULL) == 2);
        result      = result && !MapContainsKey(&map, 2);
        result      = result && (MapValueCountForKey(&map, 1) == 1);
        result      = result && MapGetFirstPtr(&map, 1) && (*MapGetFirstPtr(&map, 1) == 11);

In Map.Remove.c:81:

        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:100:

    
        bool result = (MapRemoveAll(&map, 5) == 3);
        result      = result && !MapContainsKey(&map, 5);
        result      = result && (MapValueCountForKey(&map, 5) == 0);
        result      = result && MapContainsKey(&map, 9);

In Map.Remove.c:102:

        result      = result && !MapContainsKey(&map, 5);
        result      = result && (MapValueCountForKey(&map, 5) == 0);
        result      = result && MapContainsKey(&map, 9);
        result      = result && (MapPairCount(&map) == 1);

In Map.Remove.c:122:

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

In Map.Remove.c:123:

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

In Map.Access.c:30:

        MapSetOnlyR(&map, 9, 90);
    
        bool result = MapContainsKey(&map, 7);
        result      = result && MapContainsKey(&map, 9);
        result      = result && !MapContainsKey(&map, 8);

In Map.Access.c:31:

    
        bool result = MapContainsKey(&map, 7);
        result      = result && MapContainsKey(&map, 9);
        result      = result && !MapContainsKey(&map, 8);
        result      = result && MapContainsPair(&map, 7, 70);

In Map.Access.c:32:

        bool result = MapContainsKey(&map, 7);
        result      = result && MapContainsKey(&map, 9);
        result      = result && !MapContainsKey(&map, 8);
        result      = result && MapContainsPair(&map, 7, 70);
        result      = result && MapContainsPair(&map, 7, 71);

In Map.Access.c:92:

        bool result = (found == 110);
        result      = result && (miss == 555);
        result      = result && !MapContainsKey(&map, 999);
    
        MapDeinit(&map);

In Map.Init.c:69:

    
        bool result = (reserved_capacity >= 32) && (MapCapacity(&map) == reserved_capacity) && (MapTombstones(&map) == 0) &&
                      (MapPairCount(&map) == 0) && MapEmpty(&map) && !MapContainsKey(&map, 1) && !MapContainsKey(&map, 2);
    
        MapSetOnlyR(&map, 7, 70);

In Map.Ops.c:53:

        second_value_buf[0] = 'S';
    
        result       = result && MapContainsKey(&map, "alpha");
        result       = result && !MapContainsKey(&map, key);
        result       = result && (MapValueCountForKey(&map, "alpha") == 2);

In Map.Ops.c:54:

    
        result       = result && MapContainsKey(&map, "alpha");
        result       = result && !MapContainsKey(&map, key);
        result       = result && (MapValueCountForKey(&map, "alpha") == 2);
        stored_value = MapGetFirstPtr(&map, "alpha");

In Map.Ops.c:168:

    
        bool result = (MapRetainIf(&map, retain_values_above_threshold, &threshold) == 2);
        result      = result && !MapContainsKey(&map, 1);
        result      = result && !MapContainsKey(&map, 2);
        result      = result && MapContainsKey(&map, 3);

In Map.Ops.c:169:

        bool result = (MapRetainIf(&map, retain_values_above_threshold, &threshold) == 2);
        result      = result && !MapContainsKey(&map, 1);
        result      = result && !MapContainsKey(&map, 2);
        result      = result && MapContainsKey(&map, 3);
        result      = result && MapContainsKey(&map, 4);

In Map.Ops.c:170:

        result      = result && !MapContainsKey(&map, 1);
        result      = result && !MapContainsKey(&map, 2);
        result      = result && MapContainsKey(&map, 3);
        result      = result && MapContainsKey(&map, 4);
        result      = result && (MapPairCount(&map) == 2);

In Map.Ops.c:171:

        result      = result && !MapContainsKey(&map, 2);
        result      = result && MapContainsKey(&map, 3);
        result      = result && MapContainsKey(&map, 4);
        result      = result && (MapPairCount(&map) == 2);

Last updated on June 4, 2026

MapCompact MapContainsPair