Insert an element with the specified key and value.

Synopsis

Declared in <bdlc_hashtable.h>

bool
insert(
    Handle* handle,
    KEY const& key,
    VALUE const& value);

Description

Insert an element with the specified key and the specified value into this object; load a handle to the new element into the specified handle. Return true if successful, and false otherwise. The behavior is undefined unless key and value do not evaluate to a "null" or "removed" bucket, as defined by the parameterized TRAITS (see the component‐level documentation for more details). This method will fail to compile unless the VALUE parameter is not bslmf::Nil.

Return Value

true if the element was inserted, and false otherwise

Parameters

Name

Description

handle

handle loaded with the inserted element on success

key

key of the element to insert

value

value associated with key

Created with MrDocs