std::basic_...emove_suffix(3)

💅 NAME 💅

okay bestie, welcome to the std::basic_...emove_suffix(3) page from the C++ Standard Libary — yes, the manual name is literally C++ Standard Libary, typo and all, we're not fixing it ✨

the thing itself is std::basic_string_view::remove_suffix, and the page repeats it like std::basic_string_view::remove_suffix — iconic duplication, no notes 💖

✨ Synopsis ✨

constexpr void remove_suffix( size_type n );  (since C++17)

so this is a C++17 joint: moves the end of the view back by n characters 🎀

⚠️ technical caveat, bestie: the behavior is undefined if n > size(). like, not "oopsie" undefined, actual undefined behavior — do not pass go, do not collect $200 💀

🌸 Parameters 🌸

• n — number of characters to remove from the end of the view 🫶

🦋 Return value 🦋

• (none) — literally nothing comes back, it just does its thing and returns nothing 💅

⭐ Complexity ⭐

Constant. that's the whole complexity section, constant, no cap 🔥

🎀 Example 🎀

the page says // Run this code, so here's the exact example code it points at:

#include <iostream>
#include <string_view>

int main()
{
    char arr[] = {'a', 'b', 'c', 'd', '\0', '\0', '\0'};
    std::string_view v(arr, sizeof arr);
    auto trim_pos = v.find('\0');
    if (trim_pos != v.npos)
        v.remove_suffix(v.size() - trim_pos);
    std::cout << "Array: '" << arr << "', size=" << sizeof arr << '\n'
              << "View : '" << v << "', size=" << v.size() << '\n';
}

🌈 Output 🌈

Array: 'abcd', size=7
View : 'abcd', size=4

🔥 See also 🔥

• remove_prefix — shrinks the view by moving its start forward (public member function) 👑

source: http://cppreference.com · version/date: 2024.06.10 · footer tag: std::basic_...emove_suffix(3) — mwah, bye bestie 💋✨