concurrent_unordered_map::insert Method

Adds elements to the concurrent_unordered_map object.

std::pair<iterator, bool> insert(
   const value_type& _Value
);

iterator insert(
   const_iterator _Where,
   const value_type& _Value
);

template<
   class _Iterator
>
void insert(
   _Iterator_First,
   _Iterator_Last
);

template<
   class _Valty
>
std::pair<iterator, bool> insert(
   _Valty&& _Value
);

template<
   class _Valty
>
typename std::tr1::enable_if<!std::tr1::is_same<const_iterator, typename std::tr1::remove_reference<_Valty>::type>::value, iterator>::type insert(
   const_iterator _Where,
   _Valty&& _Value
);

Parameters

• _Iterator
  The iterator type used for insertion.

• _Valty
  The type of the value inserted into the map.

• _Value
  The value to be inserted.

• _Where
  The starting location to search for an insertion point.

• _First
  The beginning of the range to insert.

• _Last
  The end of the range to insert.

Return Value

A pair that contains an iterator and a boolean value. See the Remarks section for more details.

Remarks

The first member function determines whether an element X exists in the sequence whose key has equivalent ordering to that of _Value. If not, it creates such an element X and initializes it with _Value. The function then determines the iterator where that designates X. If an insertion occurred, the function returns std::pair(where, true). Otherwise, it returns std::pair(where, false).

The second member function returns insert(_Value), using _Where as a starting place within the controlled sequence to search for the insertion point.

The third member function inserts the sequence of element values from the range [_First, _Last).

The last two member functions behave the same as the first two, except that _Value is used to construct the inserted value.

Requirements

Header: concurrent_unordered_map.h

Namespace: concurrency

See Also

Reference

concurrent_unordered_map Class