std::list::emplace

 

C++

Język

Nagłówki biblioteki standardowej

Koncepty

Biblioteka narzędzi

Biblioteka string

Biblioteka kontenerów

Biblioteka algorytmów

Biblioteka iteratorów

Biblioteka numeryczna

Biblioteka wejścia/wyjścia

Biblioteka lokalizacji

Biblioteka wyrażeń regularnych (C++11)

Biblioteka operacji atomowych (C++11)

Biblioteka obsługi wątków (C++11)

 

Kontenery

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

 

std::list

Metody

list::list

list::~list

list::operator=

list::assign

list::get_allocator

Dostęp do elementów

list::front

list::back

Iteratory

list::beginlist::cbegin (C++11)

list::endlist::cend (C++11)

list::rbeginlist::crbegin (C++11)

list::rendlist::crend (C++11)

Pojemność

list::empty

list::size

list::max_size

Modyfikatory

list::clear

list::insert

list::emplace (C++11)

list::erase

list::push_front

list::emplace_front (C++11)

list::pop_front

list::push_back

list::emplace_back (C++11)

list::pop_back

list::resize

list::swap

Operacje

list::merge

list::splice

list::removelist::remove_if

list::reverse

list::unique

list::sort

 

<tbody> </tbody>

template< class... Args > iterator emplace( const_iterator pos, Args&&... args );		(od C++11)

Wstawia nowy element do kontenera bezpośrednio przed pos. Element jest konstruowany poprzez std::allocator_traits::construct, które zazwyczaj używa placement-new do skonstruowania elementu "w miejscu"(ang), w lokalizacji zapewnionej przez kontener. Argumenty args... są przekazane do konstruktora jako std::forward<Args>(args)....

Żadne iteratory ani referencje nie zostają unieważnione.

Parametry

pos	-	iterator przed którym zostanie skonstruowany nowy element
args	-	argumenty do przekazania do konstruktora elementu
Wymagania względem typów
- T (typ elementu kontenera) musi spełniać wymagania EmplaceConstructible.

Zwracana wartość

Iterator pointing to the emplaced element.

Złożoność

Stała.

Wyjątki

Jeśli zostanie wyrzucony wyjątek (np. przez konstruktor), kontener pozostanie niezmodyfikowany, jakby funkcja nie została wywołana (strong exception guarantee).

Zobacz także

insert

wstawia elementy (publiczna metoda)