reserve: Reserve space

In cppcontainers: 'C++' Standard Template Library Containers

Reserve space

Description

Reserve space for the container by reference.

Usage

reserve(x, n)

Arguments

x	A CppUnorderedSet, CppUnorderedMultiset, CppUnorderedMap, CppUnorderedMultimap, or CppVector object.
n	The minimum number of elements per bucket.

Details

In case of a CppUnorderedSet, CppUnorderedMultiset, CppUnorderedMap, CppUnorderedMultimap, the method sets the number of buckets to be able to hold at least n elements and rehashes. In case of a CppVector, the method sets the capacity to n.

Value

Invisibly returns NULL.

See Also

bucket_count, capacity, load_factor, max_bucket_count, max_load_factor.

Examples

s <- cpp_unordered_set(4:6)
bucket_count(s)
# [1] 13
reserve(s, 3)
bucket_count(s)
# [1] 5

v <- cpp_vector(4:6)
capacity(v)
# [1] 3
reserve(v, 10)
capacity(v)
# [1] 10

cppcontainers documentation built on Sept. 9, 2025, 5:55 p.m.