set::insert

Статья
03/27/2013

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

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

Параметры

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

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

Первый функцию-член insert возвращает пару которой компонент bool возвращает true если была выполнена вставка и false, если набор уже содержал элемент, ключ которого имеет подходящего значения в упорядочение и которого компонент итератора возвращает адрес, куда был вставлен новый элемент или где элемент уже был найден.

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

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

Заметки

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

Пример

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

int main( )
{
   using namespace std;
   set <int>::iterator s1_pIter, s2_pIter;

   set <int, less<int> > s1, s2;
   s1.insert( 10 );
   s1.insert( 20 );
   s1.insert( 30 );
   s1.insert( 40 );

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

   pair< set<int>::iterator, bool > pr;
   pr = s1.insert( 10 );

   if(pr.second == true)   
   {
      cout << "The element 10 was inserted in s1 successfully."
           << endl;
   }
   else   
   {
      cout << "The element 10 already exists in s1 and"
           << " *( pr.first ) = " << *( pr.first ) << "." << endl;
   }

   s1.insert( --s1.end( ), 50 );

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

   s2.insert( 100 );
   s2.insert( ++s1.begin( ), --s1.end( ) );

   cout << "s2 =";
   for ( s2_pIter = s2.begin( ); s2_pIter != s2.end( ); s2_pIter++ )
      cout << " " << *s2_pIter;
   cout << "." << endl;

   // Construct by moving
   set<string> s3, s4;
   string str1("a"), str2("b");

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

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

Требования

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

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

См. также

Ссылки

set Class

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

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