Insert an element with the specified key into this object.

Synopsis

Declared in <bdlc_hashtable.h>

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

Description

Insert an element with the specified key 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 does not evaluate to a "null" or "removed" bucket, as defined by the parameterized TRAITS (see the component‐level documentation for more details). Note that this method will fail to compile unless the VALUE parameter is 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

Created with MrDocs