hash_set::insert

Статья
03/27/2013

Примечание
Этот API устарел.Альтернативы unordered_set Class.

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

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
);

Параметры

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

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

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

Доступ к компоненту итератора пары pr, возвращенные этим функцией-членом, использующих pr.first и разыменовать его использование *(pr.first).Доступ к компоненту bool пары pr, возвращенные этим функцией-членом, использующих pr.second и разыменовать его использование *(pr.second).

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

Заметки

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

Пример

// hash_set_insert.cpp
// compile with: /EHsc
#include <hash_set>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_set <int>::iterator hs1_pIter, hs2_pIter;

   hash_set <int, hash_compare <int, less<int> > > hs1, hs2;
   hs1.insert( 10 );
   hs1.insert( 20 );
   hs1.insert( 30 );
   hs1.insert( 40 );

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

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

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

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

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

   hs2.insert( 100 );
   hs2.insert( ++hs1.begin( ), --hs1.end( ) );

   cout << "hs2 =";
   for ( hs2_pIter = hs2.begin( ); hs2_pIter != hs2.end( );
         hs2_pIter++ )
      cout << " " << *hs2_pIter;
   cout << "." << endl;
}

Требования

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

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

См. также

Ссылки

hash_set Class

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

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