Namespaces
Variants
Views
Actions

std::vector::push_back

From cppreference.com

Template:cpp/container/vector/navbar

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

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

If new size() is not larger than capacity(), no iterators or references are invalidated. Otherwise all iterators and references are invalidated.

Contents

[edit] Parameters

value - the value of the element to append

[edit] Requirements

1) value shall be CopyInsertable

2) value shall be MoveInsertable

[edit] Return value

(none)

[edit] Complexity

Constant.

[edit] Example

The following code uses push_back to add several integers to a std::vector<int>:

#include <vector>
#include <iostream>
 
int main()
{
    std::vector<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

[edit] See also

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