std::span::front(3)

💅 std::span::front(3) — C++ Standard Library 💅

🌸 NAME 🌸

std::span::front — yes bestie, the NAME is literally std::span::front 💖 this is the manual page for std::span::front(3), and we're gonna get into it.

---

🦋 Synopsis 🦋

Here's the whole mood:

constexpr reference front() const;  (since C++20)

Returns a reference to the first element in the span.

🚨 Calling front on an empty span results in undefined behavior. Like… do not do that, bestie. That's the danger zone. 😭

---

🍓 Parameters 🍓

• (none) — literally no parameters, no cap 🫶

---

💖 Return value 💖

A reference to the first element. That's it. That's the whole return value. ✨

---

🧚 Complexity 🧚

Constant. Literally constant. Iconic behavior, no drama. 💅

---

✨ Notes ✨

For a span c, the expression c.front() is equivalent to *c.begin(). iykyk 🦋

---

💅 Example 💅

// Run this code

#include <iostream>
#include <span>

void print(std::span<const int> const data)
{
    for (auto offset{0U}; offset != data.size(); ++offset)
        std::cout << data.subspan(offset).front() << ' ';
    std::cout << '\n';
}

int main()
{
    constexpr int data[]{0, 1, 2, 3, 4, 5, 6};
    print({data, 4});
}

---

🌈 Output 🌈

0 1 2 3

---

👑 See also 👑

• back — access the last element (public member function) 🎀

---

mwah 💋 this page comes from http://cppreference.com, dated 2024.06.10, and the manual page is std::span::front(3) — periodt. 🧚‍♀️💜