map::insert (STL/CLR)
Добавляет элементы.
cliext::pair<iterator, bool> insert(value_type val);
iterator insert(iterator where, value_type val);
template<typename InIter>
void insert(InIter first, InIter last);
void insert(System::Collections::Generic::IEnumerable<value_type>^ right);
Параметры
first
Начало диапазона, который необходимо вставить.last
Элемент диапазона, который необходимо вставить.правый
Перечисление, который необходимо вставить.val
Значение ключа, который необходимо вставить., где
, Где в контейнере вставки (подсказка).
Заметки
Каждая из которых вставляет заданную последовательность функции-члены остальными операндами.
Первый функцию-член стремится вставить элемент со значением val и возвращает пару значений X.Если X.second значение равно true, то X.first соответствует новому вставленному элементу; в противном случае X.first обозначает элемент с соответствующей приказывающ то уже существует и новый элемент не добавляется.Используется для вставки одного элемента.
Второй функцию-член вставляет элемент со значением val, используя where в качестве подсказки (повысить производительность) и возвращает итератор, который соответствует новому вставленному элементу.Используется для вставки единственный элемент, который может находиться за пределами элемента известно.
Третий функцию-член вставляет последовательность [first,last).Используется для вставки ноль или несколько элементов, скопированных из другой последовательности.
Четвертый функцию-член вставляет последовательность указанный тип right.Используется для вставки последовательность, описанных перечислителем.
Каждая операция вставки предполагает время пропорциональное элемента в логарифму количество элементов в управляемой последовательности.Вставка может происходить в буферизации постоянного времени, однако, заданную подсказку, которая обозначает элемент за точкой вставки.
Пример
// cliext_map_insert.cpp
// compile with: /clr
#include <cliext/map>
typedef cliext::map<wchar_t, int> Mymap;
typedef Mymap::pair_iter_bool Pairib;
int main()
{
Mymap c1;
c1.insert(Mymap::make_value(L'a', 1));
c1.insert(Mymap::make_value(L'b', 2));
c1.insert(Mymap::make_value(L'c', 3));
// display contents " [a 1] [b 2] [c 3]"
for each (Mymap::value_type elem in c1)
System::Console::Write(" [{0} {1}]", elem->first, elem->second);
System::Console::WriteLine();
// insert a single value, unique and duplicate
// insert a single value, success and failure
Pairib pair1 = c1.insert(Mymap::make_value(L'x', 24));
System::Console::WriteLine("insert([L'x' 24]) = [[{0} {1}] {2}]",
pair1.first->first, pair1.first->second, pair1.second);
pair1 = c1.insert(Mymap::make_value(L'b', 2));
System::Console::WriteLine("insert([L'b' 2]) = [[{0} {1}] {2}]",
pair1.first->first, pair1.first->second, pair1.second);
for each (Mymap::value_type elem in c1)
System::Console::Write(" [{0} {1}]", elem->first, elem->second);
System::Console::WriteLine();
// insert a single value with hint
Mymap::iterator it =
c1.insert(c1.begin(), Mymap::make_value(L'y', 25));
System::Console::WriteLine("insert(begin(), [L'y' 25]) = [{0} {1}]",
it->first, it->second);
for each (Mymap::value_type elem in c1)
System::Console::Write(" [{0} {1}]", elem->first, elem->second);
System::Console::WriteLine();
// insert an iterator range
Mymap c2;
it = c1.end();
c2.insert(c1.begin(), --it);
for each (Mymap::value_type elem in c2)
System::Console::Write(" [{0} {1}]", elem->first, elem->second);
System::Console::WriteLine();
// insert an enumeration
Mymap c3;
c3.insert( // NOTE: cast is not needed
(System::Collections::Generic::
IEnumerable<Mymap::value_type>^)%c1);
for each (Mymap::value_type elem in c3)
System::Console::Write(" [{0} {1}]", elem->first, elem->second);
System::Console::WriteLine();
return (0);
}
Требования
заголовок: <cliext и сопоставление>
Cliext пространство имен: