Difference between revisions of "cpp/container/deque/push back"
From cppreference.com
m (r2.7.3) (Robot: Adding it:cpp/container/deque/push back, ru:cpp/container/deque/push back) |
m (langlinks) |
||
| (3 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
| − | {{cpp/container/push_back|deque}} | + | {{include page|cpp/container/push_back|deque}} |
| − | + | {{langlinks|de|es|fr|it|ja|pt|ru|zh}} | |
| − | + | ||
Latest revision as of 22:52, 9 August 2020
| 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.
All iterators (including the end() iterator) are invalidated. No references are invalidated.
Contents |
[edit] 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).
| ||
[edit] Return value
(none)
[edit] Complexity
Constant.
[edit] Exceptions
If an exception is thrown (which can be due to Allocator::allocate() or element copy/move constructor/assignment), this function has no effect (strong exception guarantee).
[edit] Example
Run this code
#include <iomanip> #include <iostream> #include <string> #include <deque> int main() { std::deque<std::string> letters; letters.push_back("abc"); std::string s{"def"}; letters.push_back(std::move(s)); std::cout << "std::deque letters holds: "; for (auto&& e : letters) std::cout << std::quoted(e) << ' '; std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n'; }
Possible output:
std::deque letters holds: "abc" "def" Moved-from string s holds: ""
[edit] See also
| (C++11) |
constructs an element in-place at the end (public member function) |
| inserts an element to the beginning (public member function) | |
| removes the last element (public member function) | |
| creates a std::back_insert_iterator of type inferred from the argument (function template) |
