std::forwar...::pop_front(3)

💖 NAME 💖

okay so bestie, this is the std::forwar...::pop_front(3) page from the C++ Standard Libary manual (yes, that's the spelling on the page — don't come for me 💀). The NAME line is out here being extra: std::forward_list::pop_front — std::forward_list::pop_front. She's the function that pops the front element of a std::forward_list. Main character energy only. 💅

✨ Synopsis ✨

void pop_front();  (since C++11)

Translation: she removes the first element of the container. That's the move. But if there are no elements in the container, the behavior is undefined — like, full stop, undefined. Do not pass go, do not collect vibes. 🫠

Also important: references and iterators to the erased element are invalidated. So if you had a ref or iterator to that first element, after the pop it's invalidated. No cap. 🦋

🌸 Parameters 🌸

(none) — no arguments, no drama. She takes nothing. 🎀

🎀 Return value 🎀

(none) — returns nothing. Does the thing and leaves. Iconic. 💖

⚡ Complexity ⚡

Constant. Literally constant. No scaling arc. ✨

🦋 Exceptions 🦋

Does not throw. Periodt. 💜

🍓 Example 🍓

The page drops // Run this code, so run this code, bestie:

// Run this code

#include <forward_list>
#include <iostream>

int main()
{
    std::forward_list<char> chars{'A', 'B', 'C', 'D'};

    for (; !chars.empty(); chars.pop_front())
        std::cout << "chars.front(): '" << chars.front() << "'\n";
}

Output:

chars.front(): 'A'
chars.front(): 'B'
chars.front(): 'C'
chars.front(): 'D'

💜 See also 💜

• push_front — inserts an element to the beginning (public member function). The opposite-direction bestie. 🫶
• front — access the first element (public member function). The peek before the pop, iykyk. 🌈

mwah 💋 — source: http://cppreference.com, version/date: 2024.06.10. That's the whole page, bestie. Slay forever. 👑💖