set::insert

Artykuł
03/26/2013

Wstawia element lub zakres elementów do zestawu.

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

Parametry

Parametr	Opis
_Val	Wartość elementu wstawiane do zestawu, chyba że zestaw zawiera już tego elementu lub, bardziej ogólnie, element, którego klucz równoważnie porządkowania.
_Where	Miejsce, aby rozpocząć wyszukiwanie dla prawidłowego punktu wstawiania.(Wstawiania może wystąpić w amortized stałego czasu nie przy logarytmiczna, jeśli punkt wstawiania następuje bezpośrednio _Where.)
_First	Pozycja pierwszego elementu do skopiowania z zestawu.
_Last	Pozycja tylko poza ostatni element do skopiowania z zestawu.

Wartość zwracana

Pierwszy wstawić Członkowskie, funkcja zwraca pary, w których składnik bool zwraca true Jeżeli wstawiania i false Jeśli zestaw zawierał element, w której klucz miał równoważnej wartości w kolejności i którego składnik iteratora zwraca adres, gdy nowy element został wstawiony lub gdy element został już znajduje.

Drugi wstawić Członkowskie, funkcja zwraca iterację, wskazującą położenie, gdy nowy element został wstawiony do zestawu.

Funkcje składowe dwóch ostatnich, działają tak samo jako pierwsze dwa, z wyjątkiem val jest używana do skonstruowania wartości wstawione.

Uwagi

Trzecią funkcję Członkowskie wstawia sekwencja wartości elementów do zestawu odpowiadające każdemu elementowi adresowane przez iterację z zakresu [_First, _Last) określonego zestawu.

Przykład

// 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;
 }

Wymagania

Nagłówek: <set>

Obszar nazw: std

Zobacz też

Informacje

set Class

Standardowa biblioteka szablonu

Udostępnij za pośrednictwem