std::list::back(3)

💖 NAME 💖

std::list::back — std::list::back (yes, the NAME section is literally that, and honestly? mood 😭). This page is from the C++ Standard Libary — yep, that's how the header spells it, and we're keeping it, bestie 💅.

---

🌸 Synopsis 🌸

reference back();             (1)
const_reference back() const; (2)

Returns a reference to the last element in the container. Simple. Iconic. Very last-element main character energy ✨.

⚠️ Calling back on an empty container causes undefined behavior. Not cute, not safe, do not do it bestie 💀.

---

✨ Parameters ✨

(none) — no arguments, no parameters, nothing to pass in. She takes zero notes and serves the last element 🎀.

---

🎀 Return value 🎀

Reference to the last element. That's the whole vibe 🫶.

---

🧚 Complexity 🧚

Constant. Fast. Reliable. Lowkey perfect 🦋.

---

🦋 Notes 🦋

For a non-empty container c, the expression c.back() is equivalent to *std::prev(c.end()). No cap, that's the exact relationship 🔥.

---

💅 Example 💅

The following code uses back to display the last element of a std::list<char>:

       // Run this code

        #include <list>
        #include <iostream>

        int main()
        {
            std::list<char> letters{'a', 'b', 'c', 'd', 'e', 'f'};

            if (!letters.empty())
                std::cout << "The last character is '" << letters.back() <<
       "'.\n";
        }

Output:

The last character is 'f'.

She ate that output, fr fr 🍓✨.

---

🌈 See also 🌈

• front — access the first element (public member function). The other end of the list, living her own life 💜.

---

source/version: http://cppreference.com · date: 2024.06.10 · page: std::list::back(3) — ty for reading bestie, mwah 🎀💖✨