MapSetOnlyR

Documentation

API Reference

MapSetOnlyR

Description

Set the value for in_key, replacing any existing entries. R-value form.

Success

Returns true. Same state effects as MapSetOnlyL minus the source-zeroing step; both sources are left untouched.

Failure

Returns false on allocation failure. The map is unchanged.

Usage example (Cross-references)

Usage examples (Cross-references)

In Map.Insert.c:29:

        MapInsertR(&map, 1, 11);
        MapInsertR(&map, 2, 20);
        MapSetOnlyR(&map, 2, 200);
        MapSetOnlyR(&map, 3, 30);

In Map.Insert.c:30:

        MapInsertR(&map, 2, 20);
        MapSetOnlyR(&map, 2, 200);
        MapSetOnlyR(&map, 3, 30);
    
        bool result = MapPairCount(&map) == 4;

In Map.Foreach.c:29:

    
        for (int i = 1; i <= 4; i++) {
            MapSetOnlyR(&map, i, i * 10);
        }
        MapInsertR(&map, 2, 25);

In Map.Remove.c:26:

        IntIntMap        map   = MapInit(i32_hash, i32_compare, &alloc);
    
        MapSetOnlyR(&map, 1, 10);
        MapInsertR(&map, 1, 11);
        MapSetOnlyR(&map, 2, 20);

In Map.Remove.c:28:

        MapSetOnlyR(&map, 1, 10);
        MapInsertR(&map, 1, 11);
        MapSetOnlyR(&map, 2, 20);
    
        bool result = MapRemoveFirst(&map, 1);

In Map.Remove.c:116:

    
        for (int i = 0; i < 12; i++) {
            MapSetOnlyR(&map, i, i + 100);
        }

In Map.Remove.c:120:

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

In Map.Access.c:26:

        IntIntMap        map   = MapInitWithValueCompare(i32_hash, i32_compare, i32_compare, &alloc);
    
        MapSetOnlyR(&map, 7, 70);
        MapInsertR(&map, 7, 71);
        MapSetOnlyR(&map, 9, 90);

In Map.Access.c:28:

        MapSetOnlyR(&map, 7, 70);
        MapInsertR(&map, 7, 71);
        MapSetOnlyR(&map, 9, 90);
    
        bool result = MapContainsKey(&map, 7);

In Map.Access.c:51:

        IntIntMap        map   = MapInit(i32_hash, i32_compare, &alloc);
    
        MapSetOnlyR(&map, 11, 110);
        MapInsertR(&map, 11, 111);

In Map.Access.c:68:

        IntIntMap        map   = MapInit(i32_hash, i32_compare, &alloc);
    
        MapSetOnlyR(&map, 11, 110);
        MapInsertR(&map, 11, 111);

In Map.Access.c:85:

        IntIntMap        map   = MapInit(i32_hash, i32_compare, &alloc);
    
        MapSetOnlyR(&map, 11, 110);
        MapInsertR(&map, 11, 111);

In Map.Init.c:71:

                      (MapPairCount(&map) == 0) && MapEmpty(&map) && !MapContainsKey(&map, 1) && !MapContainsKey(&map, 2);
    
        MapSetOnlyR(&map, 7, 70);
        result = result && (MapPairCount(&map) == 1) && (MapValueCountForKey(&map, 7) == 1);
        result = result && MapGetFirstPtr(&map, 7) && (*MapGetFirstPtr(&map, 7) == 70);

In Map.Init.c:86:

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

In Map.Init.c:121:

    
        for (int i = 0; i < 6; i++) {
            MapSetOnlyR(&map, i, i + 100);
        }

In Map.Ops.c:85:

        int red_count = 0;
    
        MapSetOnlyR(&map, "red", "apple");
        MapInsertR(&map, "red", "cherry");
        MapSetOnlyR(&map, "yellow", "banana");

In Map.Ops.c:87:

        MapSetOnlyR(&map, "red", "apple");
        MapInsertR(&map, "red", "cherry");
        MapSetOnlyR(&map, "yellow", "banana");
        MapSetOnlyR(&map, "green", "pear");
        MapRehashWithPolicy(&map, MapPairCount(&map), MapPolicyQuadratic);

In Map.Ops.c:88:

        MapInsertR(&map, "red", "cherry");
        MapSetOnlyR(&map, "yellow", "banana");
        MapSetOnlyR(&map, "green", "pear");
        MapRehashWithPolicy(&map, MapPairCount(&map), MapPolicyQuadratic);

In Insert.h:571:

    #define MapMustSetOnlyR(m, in_key, in_value)                                                                           \
        do {                                                                                                               \
            if (!MapSetOnlyR((m), (in_key), (in_value))) {                                                                 \
                LOG_FATAL("MapMustSetOnlyR failed");                                                                       \
            }                                                                                                              \

Last updated on June 4, 2026

MapSetOnlyL MapStates