bsl::set::insert

Insert value if an equivalent key is not already present.

Synopsis

Declared in <bslstl_set.h>

pair<set<KEY, COMPARATOR, ALLOCATOR>::iterator, bool>
insert(value_type const& value);

Description

Return a pair whose first member is an iterator referring to the (possibly newly inserted) value_type object in this set that is equivalent to value, and whose second member is true if a new value was inserted, and false if the key was already present. This method requires that the (template parameter) type KEY be copy-insertable into this set (see {Requirements on KEY}).

Return Value

pair of iterator and whether a new element was inserted

Parameters

NameDescription
valuekey to insert