std::list::push_back(3)

std::list::push_back(3) 💖

okay bestie, welcome to the C++ Standard Libary page for std::list::push_back ✨ this function is lowkey iconic: it just yeets a value onto the end of a list, and we're obsessed. no cap, it's giving tiny-but-mighty main character energy 🫶

---

💅 NAME 💅

std::list::push_back — std::list::push_back. yes bestie, the name really is the name 💀

✨ Synopsis ✨

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

okay so here's the whole vibe: it 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.

and the part that matters: no iterators or references are invalidated. periodt. 💅

🌸 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) — literally nothing, bestie, it's voiding in the cutest way 🫶

🔥 Complexity 🔥

Constant. that's it. no extra drama.

💀 Exceptions 💀

if an exception is thrown (which can be due to Allocator::allocate() or element copy/move constructor/assignment), this function has no effect — that's the strong exception guarantee, so you can breathe, bestie 😭💖

🌈 Example 🌈

okay so here's the code, bestie — run it, it's cute:

       // Run this code

        #include <iomanip>
        #include <iostream>
        #include <string>
        #include <list>

        int main()
        {
            std::list<std::string> letters;

            letters.push_back("abc");
            std::string s{"def"};
            letters.push_back(std::move(s));

            std::cout << "std::list 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::list 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) 🦋

---

xoxo, your Unix bestie 💖 — source: http://cppreference.com, version/date: 2024.06.10, page: std::list::push_back(3) 🎀✨