STD::BASIC_STRING_VIEW(3cxx)

💖 NAME

okay so bestie, welcome to the 3cxx manual page for std::basic_string_view< _CharT, _Traits > — A non-owning reference to a string. periodt. it's giving “look but don’t touch” energy, and yes the page header up top is a little truncated, but the manual name is 3cxx and we are rolling with it 💅.

✨ SYNOPSIS

#include <>>

copy that exactly, bestie — even if it looks like it got ate by the group chat 😭.

🎀 Public Types

• const_iterator = const value_type * — the const iterator is literally a pointer to const value_type.
• const_pointer = const value_type * — same pointer vibe, but now it’s the const pointer type.
• const_reference = const value_type & — a const reference to value_type, iconic.
• const_reverse_iterator = std::reverse_iterator< const_iterator > — reverse iterator wrapped around const_iterator, no cap.
• difference_type = ptrdiff_t — the difference type is ptrdiff_t, periodt.
• iterator = const_iterator — the iterator is just const_iterator, that’s the whole mood.
• pointer = value_type * — pointer type is value_type *.
• reference = value_type & — reference type is value_type &.
• reverse_iterator = const_reverse_iterator — reverse iterator is the const reverse iterator, slay.
• size_type = size_t — size type is size_t, yes bestie.
• traits_type = _Traits — traits type is _Traits.
• value_type = _CharT — value type is _CharT.

🧚 Public Member Functions

this is the whole roster, bestie — no skips, no “oops I forgot one” behavior 💀.

• basic_string_view ctor 1 — constexpr basic_string_view (const _CharT *__str) noexcept
• basic_string_view ctor 2 — constexpr basic_string_view (const _CharT *__str, size_type __len) noexcept
• copy ctor — constexpr basic_string_view (const basic_string_view &) noexcept=default
• at — constexpr const_reference at (size_type __pos) const
• back — constexpr const_reference back () const noexcept
• begin — constexpr const_iterator begin () const noexcept
• cbegin — constexpr const_iterator cbegin () const noexcept
• cend — constexpr const_iterator cend () const noexcept
• compare overload 1 — constexpr int compare (basic_string_view __str) const noexcept
• compare overload 2 — constexpr int compare (const _CharT *__str) const noexcept
• compare overload 3 — constexpr int compare (size_type __pos1, size_type __n1, basic_string_view __str) const
• compare overload 4 — constexpr int compare (size_type __pos1, size_type __n1, basic_string_view __str, size_type __pos2, size_type __n2) const
• compare overload 5 — constexpr int compare (size_type __pos1, size_type __n1, const _CharT *__str) const
• compare overload 6 — constexpr int compare (size_type __pos1, size_type __n1, const _CharT *__str, size_type __n2) const noexcept(false)
• copy — constexpr size_type copy (_CharT *__str, size_type __n, size_type __pos=0) const
• crbegin — constexpr const_reverse_iterator crbegin () const noexcept
• crend — constexpr const_reverse_iterator crend () const noexcept
• data — constexpr const_pointer data () const noexcept
• empty — constexpr bool empty () const noexcept
• end — constexpr const_iterator end () const noexcept
• find overload 1 — constexpr size_type find (_CharT __c, size_type __pos=0) const noexcept
• find overload 2 — constexpr size_type find (basic_string_view __str, size_type __pos=0) const noexcept
• find overload 3 — constexpr size_type find (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• find overload 4 — constexpr size_type find (const _CharT *__str, size_type __pos=0) const noexcept
• find_first_not_of overload 1 — constexpr size_type find_first_not_of (_CharT __c, size_type __pos=0) const noexcept
• find_first_not_of overload 2 — constexpr size_type find_first_not_of (basic_string_view __str, size_type __pos=0) const noexcept
• find_first_not_of overload 3 — constexpr size_type find_first_not_of (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• find_first_not_of overload 4 — constexpr size_type find_first_not_of (const _CharT *__str, size_type __pos=0) const noexcept
• find_first_of overload 1 — constexpr size_type find_first_of (_CharT __c, size_type __pos=0) const noexcept
• find_first_of overload 2 — constexpr size_type find_first_of (basic_string_view __str, size_type __pos=0) const noexcept
• find_first_of overload 3 — constexpr size_type find_first_of (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• find_first_of overload 4 — constexpr size_type find_first_of (const _CharT *__str, size_type __pos=0) const noexcept
• find_last_not_of overload 1 — constexpr size_type find_last_not_of (_CharT __c, size_type __pos=npos) const noexcept
• find_last_not_of overload 2 — constexpr size_type find_last_not_of (basic_string_view __str, size_type __pos=npos) const noexcept
• find_last_not_of overload 3 — constexpr size_type find_last_not_of (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• find_last_not_of overload 4 — constexpr size_type find_last_not_of (const _CharT *__str, size_type __pos=npos) const noexcept
• find_last_of overload 1 — constexpr size_type find_last_of (_CharT __c, size_type __pos=npos) const noexcept
• find_last_of overload 2 — constexpr size_type find_last_of (basic_string_view __str, size_type __pos=npos) const noexcept
• find_last_of overload 3 — constexpr size_type find_last_of (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• find_last_of overload 4 — constexpr size_type find_last_of (const _CharT *__str, size_type __pos=npos) const noexcept
• front — constexpr const_reference front () const noexcept
• length — constexpr size_type length () const noexcept
• max_size — constexpr size_type max_size () const noexcept
• assignment operator — constexpr basic_string_view & operator= (const basic_string_view &) noexcept=default
• operator[] — constexpr const_reference operator[] (size_type __pos) const noexcept
• rbegin — constexpr const_reverse_iterator rbegin () const noexcept
• remove_prefix — constexpr void remove_prefix (size_type __n) noexcept
• remove_suffix — constexpr void remove_suffix (size_type __n) noexcept
• rend — constexpr const_reverse_iterator rend () const noexcept
• rfind overload 1 — constexpr size_type rfind (_CharT __c, size_type __pos=npos) const noexcept
• rfind overload 2 — constexpr size_type rfind (basic_string_view __str, size_type __pos=npos) const noexcept
• rfind overload 3 — constexpr size_type rfind (const _CharT *__str, size_type __pos, size_type __n) const noexcept
• rfind overload 4 — constexpr size_type rfind (const _CharT *__str, size_type __pos=npos) const noexcept
• size — constexpr size_type size () const noexcept
• substr — constexpr basic_string_view substr (size_type __pos=0, size_type __n=npos) const noexcept(false)
• swap — constexpr void swap (basic_string_view &__sv) noexcept

🍓 Static Public Attributes

• npos — static constexpr size_type npos

🌸 Detailed Description

template time, bestie 💖:

   template<typename _CharT, typename _Traits = std::char_traits<_CharT>>
       class std::basic_string_view< _CharT, _Traits >"A non-owning reference
       to a string.

yes, that " right after the > is in the source — not me, I promise 😭. we keep every character, always.

💜 Template Parameters

• _CharT — Type of character
• _Traits — Traits for character type, defaults to char_traits<_CharT>.

A basic_string_view looks like this:

_CharT*    _M_str
size_t     _M_len

that’s the whole internal vibe: _M_str and _M_len, no cap 🫶.

🫶 Author

Generated automatically by Doxygen for libstdc++ from the source code.

source/version shoutout: libstdc++, generated by Doxygen ✨. the footer energy is libstdstd::basic_str...harT, _Traits >(3cxx), and bestie there is literally no date on the page, so I’m not inventing one — love that for us 💖🎀🦋.