multiset::insert

Статья
03/27/2013

Вставляет элемент или диапазон элементов мультинабора.

iterator insert(
   const value_type& _Val
);
iterator insert(
   const_iterator _Where,
   const value_type& _Val
);
template<class InputIterator>
   void insert(
      InputIterator _First,
      InputIterator _Last
   );
template<class ValTy>
    iterator insert(
        ValTy&& val
);
template<class ValTy>
    iterator insert(
        const_iterator _Where,
        ValTy&& _Val
);

Параметры

Параметр	Описание
_Val	Значение вставляемого элемента в конструктор multiset если мультинаборов не будет содержать этот элемент или более общем случае элемент, ключ которого соответствует упорядочен.
_Where	Размещение, чтобы начать поиск правильного точки вставки.Вставка может происходить в буферизации постоянного времени вместо основания времени, если точка вставки непосредственно за _Where.
_First	Позиция первого элемента должны быть скопированы из мультинабора.
_Last	Положение непосредственно за последним элементом быть скопированы из мультинабора.

Возвращаемое значение

Функции-члены insert возвращают итератор, который указывает на месте, куда был вставлен новый элемент в мультинабора.

Заметки

Третий функцию-член вставляет последовательность значений элементов мультинабора, соответствующий каждому элементу приготовленному итератор в диапазоне [_First, _Last) указанного мультинабора.

Последние 2 функции-члена ведут себя так же, как и первые 2, за исключением того, что val используется для построения вставляемое значение.

Пример

// multiset_insert.cpp
// compile with: /EHsc
#include <set>
#include <iostream>
#include <string>

int main( )
{
   using namespace std;
   multiset <int>::iterator ms1_pIter, ms2_pIter;

   multiset <int, less<int> > ms1, ms2;
   ms1.insert( 10 );
   ms1.insert( 20 );
   ms1.insert( 30 );
   ms1.insert( 40 );

   cout << "The original ms1 =";
   for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
      cout << " " << *ms1_pIter;
   cout << "." << endl;

   ms1.insert( 20 );
   ms1.insert( --ms1.end( ), 50 );

   cout << "After the insertions, ms1 =";
   for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
      cout << " " << *ms1_pIter;
   cout << "." << endl;

   ms2.insert( 100 );
   ms2.insert( ++ms1.begin( ), --ms1.end( ) );

   cout << "ms2 =";
   for ( ms2_pIter = ms2.begin( ); ms2_pIter != ms2.end( ); ms2_pIter++ )
      cout << " " << *ms2_pIter;
   cout << "." << endl;

   // Construct by moving
   multiset<string> ms3, ms4;
   string str1("a"), str2("b");

   ms3.insert(move(str1));
   cout << "After the move insertion, ms3 contains: "
      << *ms3.begin() << endl;

   ms4.insert(ms4.begin(), move(str2));
   cout << "After the move insertion, ms4 contains: "
      << *ms4.begin() << endl;
}

Требования

заголовок: <set>

std пространство имен:

См. также

Ссылки

multiset Class

Стандартная библиотека шаблонов

Поделиться через