std::list::push_back

 

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>

void push_back( const T& value );	(1)
void push_back( T&& value );	(2)	(od C++11)

Dodaje nowy element value na koniec kontenera.

1) Nowy element jest inicjalizowany jako kopia value.

2) value jest przenoszone do nowego elementu.

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

Parametry

value	-	wartość dodawanego elementu
Wymagania względem typów
- T musi spełniać wymagania CopyInsertable aby użyć przeciążenia (1).
- T musi spełniać wymagania MoveInsertable aby użyć przeciążenia (2).

Zwracana wartość

(none)

Złożoność

Stała.

Wyjątki

Jeśli zostanie wyrzucony wyjątek (co może nastąpić w związku z alokacją pamięci Allocator::allocate() lub konstrukcją/przypisaniem elementu za pomocą kopiowania lub przeniesienia), funkcja nie zmieni wartości kontenera (strong exception guarantee).

Przykład

#include <list>
#include <iostream>
#include <iomanip>
 
int main()
{
    std::list<std::string> numbers;
 
    numbers.push_back("abc");
    std::string s = "def";
    numbers.push_back(std::move(s));

    std::cout << "list holds: ";
    for (auto&& i : numbers) std::cout << std::quoted(i) << ' ';
    std::cout << "\nMoved-from string holds " << std::quoted(s) << '\n';
}

Wynik:

list holds: "abc" "def" 
Moved-from string holds ""

Zobacz także

emplace_back (C++11)	konstruuje element "w miejscu" na końcu (publiczna metoda)
push_front	wstawia element na początek (publiczna metoda)
pop_back	usuwa ostatni element (publiczna metoda)