Namespaces
Variants
Views
Actions

std::list::push_back

From cppreference.com
< cpp‎ | container‎ | list
Revision as of 20:21, 2 November 2012 by P12bot (Talk | contribs)

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

Appends the given element value to the end of the container.

1) The new element is initialized as a copy of value.
2) value is moved into the new element.

No iterators or references are invalidated.

Contents

Parameters

value - the value of the element to append
Type requirements
-
T must meet the requirements of CopyInsertable in order to use overload (1).
-
T must meet the requirements of MoveInsertable in order to use overload (2).

Return value

(none)

Complexity

Constant.

Exceptions

If an exception is thrown, this function has no effect (strong exception guarantee).


Example

#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';
}

Output:

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

See also

constructs elements in-place at the end
(public member function) [edit]
inserts elements to the beginning
(public member function) [edit]
removes the last element
(public member function) [edit]