Namespaces
Variants
Views
Actions

Difference between revisions of "Template:cpp/container/push back"

From cppreference.com
(be explicit that a copy is made for the const T& overload)
(use {{cpp/std}})
Line 2: Line 2:
 
{{cpp/container/{{{1|}}}/navbar}}
 
{{cpp/container/{{{1|}}}/navbar}}
 
{{dcl begin}}
 
{{dcl begin}}
{{dcl | num=1 | notes={{cpp/container/mark since c++11 | {{{1|}}} }} |
+
{{dcl | since={{cpp/std|{{{1|}}}}} |
 
void push_back( const T& value );
 
void push_back( const T& value );
 
}}
 
}}

Revision as of 07:21, 29 July 2013

void push_back( const T& value );
(since {std})
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.

Contents

Parameters

value - the value of the element to append
Type requirements

Template:par req concept Template:par req concept

Return value

(none)

Complexity

Constant.

Example

The following code uses push_back to add several integers to a std::{{{1}}}<int>:

#include <{{{1}}}>
#include <iostream>
 
int main()
{
    std::{{{1}}}<int> numbers;
 
    numbers.push_back(42);
    numbers.push_back(314159); 
 
    for (int i : numbers) { // c++11 range-based for loop
        std::cout << i << '\n';
    } 
 
    return 0;
}

Output:

42
314159

See also

constructs an element in-place at the end
(public member function of std::{{{1}}}) [edit]
inserts an element to the beginning
(public member function of std::{{{1}}}) [edit]
removes the last element
(public member function of std::{{{1}}}) [edit]