Skip to content

MapReserve

Description

Reserve enough probe slots for at least n entries.

Parameters

Name Direction Description
m in,out Hash map.
n in Minimum number of entries expected.

Success

Returns true. The probe table now has capacity for at least n entries without triggering a rehash. Existing entries are preserved (a rehash into the larger table is performed if growth was needed). Map length is unchanged.

Failure

Returns false on allocation failure. The map is unchanged.

Usage example (Cross-references)

Usage examples (Cross-references)
        size             reserved_capacity;
    
        MapReserve(&map, 32);
        reserved_capacity = (size)MapCapacity(&map);
    #define MapMustReserve(m, n)                                                                                           \
        do {                                                                                                               \
            if (!MapReserve((m), (n))) {                                                                                   \
                LOG_FATAL("MapMustReserve failed");                                                                        \
            }                                                                                                              \
Last updated on