std::deque::push_back(3)

💖 std::deque::push_back(3) 💖

🎀 NAME 🎀

std::deque::push_back - std::deque::push_back — bestie, this is the C++ Standard Libary manual page for std::deque::push_back, section 3, and it's here to explain the whole append-to-the-end situation 💅.

🌸 Synopsis 🌸

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

It appends the given element value to the end of the container — literally yeeting it onto the end 🫶.

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. No cap.

💜 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) — nothing comes back, bestie 😭. It's giving void energy.

🔥 Complexity 🔥

Constant. Periodt. ✨

💀 Exceptions 💀

If an exception is thrown — and that can be due to Allocator::allocate() or element copy/move constructor/assignment — this function has no effect. That's the strong exception guarantee, and yes it's giving safety 💅.

✨ 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: ""

🌈 See also 🌈

• emplace_back — constructs an element in-place at the end. (C++11) (public member function)
• push_front — inserts an element to the beginning. (public member function)
• pop_back — removes the last element. (public member function)
• back_inserter — creates a std::back_insert_iterator of type inferred from the argument. (function template)

okay that's the whole page! 💖 source: http://cppreference.com — version/date: 2024.06.10 — page: std::deque::push_back(3) 🫶✨