__GNU_CXX::__VERSA_STRING(3cxx)

📦

version 14-20240412 · 18 versions

okay so bestie, this is a 3cxx manual page, and it’s all about the template class __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base > 💖 yes the name is huge, we’re handling it.

🌸 NAME 🌸

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base > — Template class __versa_string. that’s the whole NAME, short and iconic ✨

✨ SYNOPSIS ✨

to summon this thing, you literally type:

#include <vstring.h>

and it inherits from _Base< _CharT, _Traits, _Alloc > — yes, exactly like that, spaces and all 🫶

🎀 Public Types 🎀

typedef _Alloc allocator_type — the allocator_type alias, serving its little typedef moment 💅
typedef __gnu_cxx::__normal_iterator< const_pointer, __versa_string > const_iterator — const_iterator, no cap 👑
typedef _CharT_alloc_traits::const_pointer const_pointer — the const_pointer typedef, right here bestie ✨
typedef const value_type & const_reference — const_reference, living that reference life 🎀
typedef std::reverse_iterator< const_iterator > const_reverse_iterator — const_reverse_iterator, iconic reverse energy 🦋
typedef _CharT_alloc_type::difference_type difference_type — difference_type, periodt 🌸
typedef __gnu_cxx::__normal_iterator< pointer, __versa_string > iterator — iterator, main character typedef fr fr 💜
typedef _CharT_alloc_traits::pointer pointer — the pointer alias, slay 🔥
typedef value_type & reference — reference, lowkey essential 💖
typedef std::reverse_iterator< iterator > reverse_iterator — reverse_iterator, going backwards but make it cute 🙈
typedef _CharT_alloc_type::size_type size_type — size_type, holding it down ⭐
typedef _Traits traits_type — traits_type, the vibes alias 🧚
typedef _Traits::char_type value_type — value_type, final typedef of this batch, and yes it ate 💅

okay so we're deep in the member function list now and bestie there are SO many 💅 constructors first, because of course this class has like ten ways to be born. iconic behaviour honestly.

__versa_string (__versa_string &&__str) noexcept — the string move constructor. yes she moves, noexcept and everything, no cap ✨
template<class _InputIterator , typename = std::_RequireInputIter<_InputIterator>> __versa_string (_InputIterator __beg, _InputIterator __end, const _Alloc &__a=_Alloc()) — builds the string as a copy of a range, from __beg to __end, with the allocator defaulting to _Alloc() 🦋
__versa_string (const __versa_string &__str) — the classic copy constructor: construct a string with a copy of the value of __str 💖
__versa_string (const __versa_string &__str, size_type __pos, size_type __n, const _Alloc &__a) — construct the string as a copy of a substring — you hand it the source, a __pos, an __n, and an allocator 🌸
__versa_string (const __versa_string &__str, size_type __pos, size_type __n=npos) — same substring-copy vibe, but __n defaults to npos so you can yeet it ☁️
__versa_string (const _Alloc &__a=_Alloc()) noexcept — construct an empty string using allocator a, and it's noexcept so she's calm 🎀
__versa_string (const _CharT *__s, const _Alloc &__a=_Alloc()) — construct the string as a copy of a C string 🔥
__versa_string (const _CharT *__s, size_type __n, const _Alloc &__a=_Alloc()) — construct a string initialized by a character array, __n characters of it, allocator optional 💫
__versa_string (size_type __n, _CharT __c, const _Alloc &__a=_Alloc()) — construct the string as multiple characters: __n copies of __c. it's giving "repeat after me" 😌
__versa_string (std::initializer_list< _CharT > __l, const _Alloc &__a=_Alloc()) — construct the string from an initializer_list. brace-init girlies rise 🫶
~__versa_string () noexcept — destroy the string instance. she's done, she's logging off, noexcept 💀

template<typename _InputIterator > __versa_string< _CharT, _Traits, _Alloc, _Base > & _M_replace_dispatch (const_iterator __i1, const_iterator __i2, _InputIterator __k1, _InputIterator __k2, std::__false_type) — the page genuinely gives no blurb for this one, so I'm not inventing lore. signature only, bestie 🙈

now the append era begins. big era.

template<class _InputIterator , typename = std::_RequireInputIter<_InputIterator>> __versa_string & append (_InputIterator __first, _InputIterator __last) — append a range of characters, __first through __last 🌈
__versa_string & append (const __versa_string &__str) — append a string to this string. she's stacking ✨
__versa_string & append (const __versa_string &__str, size_type __pos, size_type __n) — append a substring of __str, starting at __pos, __n long 🍓
__versa_string & append (const _CharT *__s) — append a C string 💅
__versa_string & append (const _CharT *__s, size_type __n) — append a C substring, __n chars of it 🦋
__versa_string & append (size_type __n, _CharT __c) — append multiple characters: __n copies of __c 👑
__versa_string & append (std::initializer_list< _CharT > __l) — append an initializer_list of characters 💜

assign next, aka "no actually, be this instead":

__versa_string & assign (__versa_string &&__str) noexcept — set value to the contents of another string, via move. noexcept obviously ⭐
template<class _InputIterator , typename = std::_RequireInputIter<_InputIterator>> __versa_string & assign (_InputIterator __first, _InputIterator __last) — set value to a range of characters 🌸
__versa_string & assign (const __versa_string &__str) — set value to the contents of another string 💖
__versa_string & assign (const __versa_string &__str, size_type __pos, size_type __n) — set value to a substring of a string, __pos and __n style 🎀
__versa_string & assign (const _CharT *__s) — set value to the contents of a C string 🔥
__versa_string & assign (const _CharT *__s, size_type __n) — set value to a C substring 😭
__versa_string & assign (size_type __n, _CharT __c) — set value to multiple characters: __n of __c ✨
__versa_string & assign (std::initializer_list< _CharT > __l) — set value to an initializer_list of characters 🧚

reference at (size_type __n) — provides access to the data contained in the string, at __n 🫶
const_reference at (size_type __n) const — same, but the const flavour 💅
const_reference back () const noexcept — signature only, the page gives no blurb, so no invented lore from me 🙈
reference back () noexcept — again, signature and nothing else 💀
const_iterator begin () const noexcept — signature only 🌸
iterator begin () noexcept — signature only 🦋
const _CharT * c_str () const noexcept — return a const pointer to the null-terminated contents ⭐
size_type capacity () const noexcept — signature only, no blurb on the page 💜
const_iterator cbegin () const noexcept — signature only ✨
const_iterator cend () const noexcept — signature only 🎀
void clear () noexcept — signature only, noexcept ✅

the compare girlies. six of them. she's thorough.

int compare (const __versa_string &__str) const — compare to a string 🔍
int compare (const _CharT *__s) const — compare to a C string 🔍
int compare (size_type __pos, size_type __n, const __versa_string &__str) const — compare a substring to a string 🔍
int compare (size_type __pos, size_type __n1, const _CharT *__s) const — compare a substring to a C string 🔍
int compare (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2) const — compare a substring against a character array, with __n1 and __n2 both in play 😤
int compare (size_type __pos1, size_type __n1, const __versa_string &__str, size_type __pos2, size_type __n2) const — compare a substring to a substring. yes, both sides get pos-and-n. it's giving ✨symmetry✨
size_type copy (_CharT *__s, size_type __n, size_type __pos=0) const — copy a substring into a C string, __n chars, __pos defaulting to 0 🍓

const_reverse_iterator crbegin () const noexcept — signature only, no blurb given 🌈
const_reverse_iterator crend () const noexcept — signature only 💫
const _CharT * data () const noexcept — return a const pointer to the contents 🫶
bool empty () const noexcept — signature only ✨
const_iterator end () const noexcept — signature only 🎀
iterator end () noexcept — signature only 🦋

erase hours 😤

iterator erase (const_iterator __first, const_iterator __last) — remove a range of characters, __first to __last 💀
iterator erase (const_iterator __position) — remove one character at __position 🙈
__versa_string & erase (size_type __pos=0, size_type __n=npos) — remove characters, with __pos defaulting to 0 and __n defaulting to npos 🔥

now the search arc. the find family ate, honestly:

size_type find (_CharT __c, size_type __pos=0) const noexcept — find the position of a character, __pos defaults 0, noexcept 🔍
size_type find (const __versa_string &__str, size_type __pos=0) const noexcept — find the position of a string 🔍
size_type find (const _CharT *__s, size_type __pos, size_type __n) const — find the position of a C substring 🔍
size_type find (const _CharT *__s, size_type __pos=0) const — find the position of a C string 🔍

find_first_not_of — the contrarian queen 👑

size_type find_first_not_of (_CharT __c, size_type __pos=0) const noexcept — find the position of a different character 🔍
size_type find_first_not_of (const __versa_string &__str, size_type __pos=0) const noexcept — find the position of a character not in the string 🔍
size_type find_first_not_of (const _CharT *__s, size_type __pos, size_type __n) const — find the position of a character not in a C substring 🔍
size_type find_first_not_of (const _CharT *__s, size_type __pos=0) const — find the position of a character not in a C string 🔍

find_first_of — back to the agreeable era ✨

size_type find_first_of (_CharT __c, size_type __pos=0) const noexcept — find the position of a character 🔍
size_type find_first_of (const __versa_string &__str, size_type __pos=0) const noexcept — find the position of a character of the string 🔍
size_type find_first_of (const _CharT *__s, size_type __pos, size_type __n) const — find the position of a character of a C substring 🔍
size_type find_first_of (const _CharT *__s, size_type __pos=0) const — find the position of a character of a C string 🔍

find_last_not_of — same energy, but from the BACK 🔙

size_type find_last_not_of (_CharT __c, size_type __pos=npos) const noexcept — find the last position of a different character, __pos defaults to npos 🔍
size_type find_last_not_of (const __versa_string &__str, size_type __pos=npos) const noexcept — find the last position of a character not in the string 🔍
size_type find_last_not_of (const _CharT *__s, size_type __pos, size_type __n) const — find the last position of a character not in a C substring 🔍
size_type find_last_not_of (const _CharT *__s, size_type __pos=npos) const — find the last position of a character not in a C string 🔍

find_last_of — closing out the search saga 🎬

size_type find_last_of (_CharT __c, size_type __pos=npos) const noexcept — find the last position of a character 🔍
size_type find_last_of (const __versa_string &__str, size_type __pos=npos) const noexcept — find the last position of a character of the string 🔍
size_type find_last_of (const _CharT *__s, size_type __pos, size_type __n) const — find the last position of a character of a C substring 🔍
size_type find_last_of (const _CharT *__s, size_type __pos=npos) const — find the last position of a character of a C string 🔍

const_reference front () const noexcept — signature only, no blurb 🫶
reference front () noexcept — signature only 💅
allocator_type get_allocator () const noexcept — return a copy of the allocator used to construct this string 💖

insert overloads, aka "let me just squeeze this in" 😌

iterator insert (const_iterator __p, _CharT __c) — insert one character at __p ✨
template<class _InputIterator , typename = std::_RequireInputIter<_InputIterator>> iterator insert (const_iterator __p, _InputIterator __beg, _InputIterator __end) — insert a range of characters at __p 🦋
iterator insert (const_iterator __p, size_type __n, _CharT __c) — insert multiple characters, __n of __c 🌸
iterator insert (const_iterator __p, std::initializer_list< _CharT > __l) — insert an initializer_list of characters 🎀
__versa_string & insert (size_type __pos, const _CharT *__s) — insert a C string at __pos 🔥
__versa_string & insert (size_type __pos, const _CharT *__s, size_type __n) — insert a C substring 🔥
__versa_string & insert (size_type __pos, size_type __n, _CharT __c) — insert multiple characters 💫
__versa_string & insert (size_type __pos1, const __versa_string &__str) — insert the value of a string at __pos1 💜
__versa_string & insert (size_type __pos1, const __versa_string &__str, size_type __pos2, size_type __n) — insert a substring. positions on positions 😤

size_type length () const noexcept — returns the number of characters in the string, not including any null-termination 📏
size_type max_size () const noexcept — returns the size() of the largest possible string 👑

operator era 💅

__versa_string & operator+= (_CharT __c) — append a character 🌸
__versa_string & operator+= (const __versa_string &__str) — append a string to this string 🦋
__versa_string & operator+= (const _CharT *__s) — append a C string 🎀
__versa_string & operator+= (std::initializer_list< _CharT > __l) — append an initializer_list of characters ✨
__versa_string & operator= (__versa_string &&__str) noexcept — the string move assignment operator. noexcept and unbothered 💀
__versa_string & operator= (_CharT __c) — set value to a string of length 1 🍓
__versa_string & operator= (const __versa_string &__str) — assign the value of str to this string 💖
__versa_string & operator= (const _CharT *__s) — copy the contents of __s into this string 🔥
__versa_string & operator= (std::initializer_list< _CharT > __l) — set value to a string constructed from an initializer list 🌈
const_reference operator[] (size_type __pos) const noexcept — subscript access to the data contained in the string, const flavour ✨
reference operator[] (size_type __pos) noexcept — subscript access to the data contained in the string 💅
void pop_back () — remove the last character. bye bestie 👋
void push_back (_CharT __c) — append a single character 🫶
const_reverse_iterator rbegin () const noexcept — signature only, no blurb 💜
reverse_iterator rbegin () noexcept — signature only 🧚
const_reverse_iterator rend () const noexcept — signature only ⭐
reverse_iterator rend () noexcept — signature only 🌸

aaaaand we land on replace, where the page literally cuts itself off mid-signature:

__versa_string & replace (const_iterator __i1, const_iterator __i2, — and that's where this part of the page runs out of room 😭 signature's not finished, no blurb either, so we're picking this up right where it left off next time 🎀

…_CharT *__k1, _CharT *__k2) — ok that's literally just the tail end of one of the replace overloads hanging out mid-signature, we're picking up right there bestie, no restart, no recap 💖

template<class _InputIterator , typename = std::_RequireInputIter<_InputIterator>> __versa_string & replace (const_iterator __i1, const_iterator __i2, _InputIterator __k1, _InputIterator __k2) — replace range of characters with range ✨
__versa_string & replace (const_iterator __i1, const_iterator __i2, const __versa_string &__str) — replace range of characters with string
__versa_string & replace (const_iterator __i1, const_iterator __i2, const _CharT *__k1, const _CharT *__k2)
__versa_string & replace (const_iterator __i1, const_iterator __i2, const _CharT *__s) — replace range of characters with C string
__versa_string & replace (const_iterator __i1, const_iterator __i2, const _CharT *__s, size_type __n) — replace range of characters with C substring
__versa_string & replace (const_iterator __i1, const_iterator __i2, const_iterator __k1, const_iterator __k2)
__versa_string & replace (const_iterator __i1, const_iterator __i2, iterator __k1, iterator __k2)
__versa_string & replace (const_iterator __i1, const_iterator __i2, size_type __n, _CharT __c) — replace range of characters with multiple characters
__versa_string & replace (const_iterator __i1, const_iterator __i2, std::initializer_list< _CharT > __l) — replace range of characters with initializer_list
__versa_string & replace (size_type __pos, size_type __n, const __versa_string &__str) — replace characters with value from another string
__versa_string & replace (size_type __pos, size_type __n1, const _CharT *__s) — replace characters with value of a C string
__versa_string & replace (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2) — replace characters with value of a C substring
__versa_string & replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c) — replace characters with multiple characters
__versa_string & replace (size_type __pos1, size_type __n1, const __versa_string &__str, size_type __pos2, size_type __n2) — replace characters with value from another string

ok and yes, some of those have no little description attached in the source — the ones with nothing after them are just signature-and-vibes, I'm not gonna make up lore for them 🙈

void reserve (size_type __res_arg=0) — attempt to preallocate enough memory for specified number of characters 💅
void resize (size_type __n) — resizes the string to the specified number of characters
void resize (size_type __n, _CharT __c) — resizes the string to the specified number of characters
size_type rfind (_CharT __c, size_type __pos=npos) const noexcept — find last position of a character
size_type rfind (const __versa_string &__str, size_type __pos=npos) const noexcept — find last position of a string
size_type rfind (const _CharT *__s, size_type __pos, size_type __n) const — find last position of a C substring
size_type rfind (const _CharT *__s, size_type __pos=npos) const — find last position of a C string
void shrink_to_fit () noexcept — a non-binding request to reduce capacity() to size() (non-binding!! she might not listen, that's the whole point 🫶)
size_type size () const noexcept — returns the number of characters in the string, not including any null-termination
__versa_string substr (size_type __pos=0, size_type __n=npos) const — get a substring
void swap (__versa_string &__s) noexcept — swap contents with another string

🦋 STATIC PUBLIC ATTRIBUTES 🦋

static const size_type npos — the value returned by various member functions when they fail. icon behavior honestly, she has one job and she does it 💀

💜 DETAILED DESCRIPTION 💜

template<typename _CharT, typename _Traits, typename _Alloc, template<
    typename, typename, typename > class _Base>
class __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >

Template class __versa_string.

Data structure managing sequences of characters and character-like objects. that's it, that's the whole vibe check ✨

🎀 CONSTRUCTOR & DESTRUCTOR DOCUMENTATION 🎀

the default one 🌸

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const _Alloc & __a =
    _Alloc()) [inline],  [explicit],  [noexcept]

Construct an empty string using allocator a. three badges at once — [inline], [explicit], [noexcept] — she's serving, we love a multi-tag queen 👑

copy constructor 💖

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const __versa_string<
    _CharT, _Traits, _Alloc, _Base > & __str) [inline]

Construct string with copy of value of __str.

Parameters

__str — source string.

move constructor 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (__versa_string<
    _CharT, _Traits, _Alloc, _Base > && __str) [inline],  [noexcept]

String move constructor.

Parameters

__str — source string.

The newly-constructed string contains the exact contents of __str. The contents of __str are a valid, but unspecified string — so like, don't go reading __str afterwards expecting the same thing, she's moved out and living her new life 😭

initializer_list constructor 🍓

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (std::initializer_list<
    _CharT > __l, const _Alloc & __a = _Alloc()) [inline]

Construct string from an initializer list.

Parameters

__l — std::initializer_list of characters.
__a — allocator to use (default is default allocator).

substring constructors 🌈

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const __versa_string<
    _CharT, _Traits, _Alloc, _Base > & __str, size_type __pos, size_type __n
    = npos) [inline]

Construct string as copy of a substring.

Parameters

__str — source string.
__pos — index of first character to copy from.
__n — number of characters to copy (default remainder).

and the same thing but with an allocator, because she likes options:

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const __versa_string<
    _CharT, _Traits, _Alloc, _Base > & __str, size_type __pos, size_type
    __n, const _Alloc & __a) [inline]

Construct string as copy of a substring.

Parameters

__str — source string.
__pos — index of first character to copy from.
__n — number of characters to copy.
__a — allocator to use.

character array constructor 💅

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const _CharT * __s,
    size_type __n, const _Alloc & __a = _Alloc()) [inline]

Construct string initialized by a character array.

Parameters

__s — source character array.
__n — number of characters to copy.
__a — allocator to use (default is default allocator).

NB: __s must have at least __n characters, '\0' has no special meaning. like, none. zero. don't come at her with your null terminator assumptions 🚨

C string constructor ⭐

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (const _CharT * __s,
    const _Alloc & __a = _Alloc()) [inline]

Construct string as copy of a C string.

Parameters

__s — source C string.
__a — allocator to use (default is default allocator).

the "n copies of one character" constructor 🌸

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::__versa_string (size_type __n, _CharT
    __c, const _Alloc & __a = _Alloc()) [inline]

Construct string as multiple characters.

Parameters

__n — number of characters.
__c — character to use.
__a — allocator to use (default is default allocator).

the iterator range constructor ✨

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> template<class
_InputIterator , typename  = std::_RequireInputIter<_InputIterator>>
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
>::__versa_string (_InputIterator __beg, _InputIterator __end, const
_Alloc & __a = _Alloc()) [inline]

Construct string as copy of a range.

Parameters

__beg — start of range.
__end — end of range.
__a — allocator to use (default is default allocator).

destructor 💀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::~__versa_string () [inline],
    [noexcept]

Destroy the string instance. bye bestie, [inline] and [noexcept] on the way out too, classy till the end 🫶

✨ MEMBER FUNCTION DOCUMENTATION ✨

`append` — the range one 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> template<class
_InputIterator , typename  = std::_RequireInputIter<_InputIterator>>
__versa_string & __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc,
_Base >::append (_InputIterator __first, _InputIterator __last) [inline]

Append a range of characters.

Parameters

__first — iterator referencing the first character to append.
__last — iterator marking the end of the range.

Returns — reference to this string.

Appends characters in the range [first,last) to this string.

References — __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

`append` — the whole-string one 👑

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
(const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str)
[inline]

Append a string to this string.

Parameters

__str — the string to append.

Returns — reference to this string.

References — __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by — __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append(), std::getline(), __gnu_cxx::operator+(), __gnu_cxx::operator+(), __gnu_cxx::operator+(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=(). she's a collaborator, everyone wants her on the track 💅

`append` — the substring one 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
(const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str,
size_type __pos, size_type __n) [inline]

Append a substring.

Parameters

__str — the string to append.
__pos — index of the first character of str to append.
__n — the number of characters to append.

Returns — reference to this string.

ok that's where we're pausing, hold that thought, there's more append coming and I'm not done hyping her up 😭

Exceptions — std::out_of_range if pos is not a valid index.

This function appends __n characters from __str starting at __pos to this string. If __n is larger than the number of available characters in __str, the remainder of __str is appended. simple, clean, no cap 💖

append — C string era 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
    (const _CharT * __s) [inline]

Append a C string. yes bestie, just the whole string ✨

Parameters: __s — the C string to append.
Returns: reference to this string.

append — C substring edition 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
    (const _CharT * __s, size_type __n) [inline]

Append a C substring. a lil slice of the C string, iconic 💅

Parameters: __s — the C string to append; __n — the number of characters to append.
Returns: reference to this string.

append — multiple characters, okay?? 💀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
    (size_type __n, _CharT __c) [inline]

Append multiple characters. we're literally just stacking copies 🍓

Parameters: __n — the number of characters to append; __c — the character to use.
Returns: reference to this string.

Appends n copies of c to this string.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

append — initializer_list moment ✨

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append
    (std::initializer_list< _CharT > __l) [inline]

Append an initializer_list of characters. the curly-brace girlies ate 🎀

Parameters: __l — the initializer_list of characters to append.
Returns: reference to this string.
References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append().

assign — move assignment but make it cute 💖

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (__versa_string< _CharT, _Traits, _Alloc, _Base > && __str) [inline],
    [noexcept]

Set value to contents of another string. moving, not copying — main character energy 👑

Parameters: __str — source string to use.
Returns: reference to this string.

This function sets this string to the exact contents of __str. __str is a valid, but unspecified string.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::swap().

assign — range of characters 🌈

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> template<class
    _InputIterator , typename  = std::_RequireInputIter<_InputIterator>>
    __versa_string & __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc,
    _Base >::assign (_InputIterator __first, _InputIterator __last) [inline]

Set value to a range of characters. iterators in, vibes out 🦋

Parameters: __first — iterator referencing the first character to append; __last — iterator marking the end of the range.
Returns: reference to this string.

Sets value of string to characters in the range [first,last).

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

assign — copy assignment, the classic 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str)
    [inline]

Set value to contents of another string. the copy-paste bestie we know and love 💅

Parameters: __str — source string to use.
Returns: reference to this string.
Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=().

assign — substring of a string 🍓

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str,
    size_type __pos, size_type __n) [inline]

Set value to a substring of a string. grab a chunk, leave the rest ✨

Parameters: __str — the string to use; __pos — index of the first character of str; __n — number of characters to use.
Returns: reference to this string.
Exceptions: std::out_of_range if __pos is not a valid index.

This function sets this string to the substring of __str consisting of __n characters at __pos. If __n is larger than the number of available characters in __str, the remainder of __str is used.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

assign — C string, but make it safe 🧚

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (const _CharT * __s) [inline]

Set value to contents of a C string. copied, so no lingering dependence 🌸

Parameters: __s — the C string to use.
Returns: reference to this string.

This function sets the value of this string to the value of __s. The data is copied, so there is no dependence on __s once the function returns.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

assign — C substring, bestie sized 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (const _CharT * __s, size_type __n) [inline]

Set value to a C substring. first __n characters, periodt 💅

Parameters: __s — the C string to use; __n — number of characters to use.
Returns: reference to this string.

This function sets the value of this string to the first __n characters of __s. If __n is larger than the number of available characters in __s, the remainder of __s is used.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

assign — multiple characters, we love a repeat 🔥

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (size_type __n, _CharT __c) [inline]

Set value to multiple characters. __n copies of __c, no notes 🎀

Parameters: __n — length of the resulting string; __c — the character to use.
Returns: reference to this string.

This function sets the value of this string to __n copies of character __c.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

assign — initializer_list assigns 💖

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign
    (std::initializer_list< _CharT > __l) [inline]

Set value to an initializer_list of characters. curly braces stay winning ✨

Parameters: __l — the initializer_list of characters to assign.
Returns: reference to this string.
References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign().

at — the safe access era 👑

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> reference
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::at
    (size_type __n) [inline]

Provides access to the data contained in the string. bounds-checked, because we're responsible 🫶

Parameters: __n — the index of the character to access.
Returns: read/write reference to the character.
Exceptions: std::out_of_range if __n is an invalid index.

This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails. Success results in unsharing the string.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

at const — same safety, no editing 🔒

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reference
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::at
    (size_type __n) const [inline]

Provides access to the data contained in the string. read-only, look but don't touch 💅

Parameters: __n — the index of the character to access.
Returns: read-only (const) reference to the character.
Exceptions: std::out_of_range if __n is an invalid index.

This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

back const — last character, but make it const 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reference
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back ()
    const [inline],  [noexcept]

Returns a read-only (constant) reference to the data at the last element of the string. the final girlie, no changes allowed 💖

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[](), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

back — last character, now with edits 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> reference
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back ()
    [inline],  [noexcept]

Returns a read/write reference to the data at the last element of the string. last element said "let me be editable" ✨

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[](), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

begin const — first character, read-only 🌸

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::begin ()
    const [inline],  [noexcept]

Returns a read-only (constant) iterator that points to the first character in the string. peek only, bestie 🫶

begin — first character, full access 👑

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::begin ()
    [inline],  [noexcept]

Returns a read/write iterator that points to the first character in the string. Unshares the string. the way that begin() unshares? iconic. 💅

Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::crend(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rend(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rend().

🌟 `c_str()` — the raw-pointer moment

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const _CharT *
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::c_str ()
    const [inline],  [noexcept]

Returns a const pointer to the null-terminated contents 💖. It's a handle to internal data — like, that's the string's actual luggage, not a copy, no cap.

⚠️ Do not modify it or, and I quote, "dire things may happen." Bestie the manpage said dire. Believe it. 😭💀

📦 `capacity()` — how much room before the next glow-up

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::capacity ()
    const [inline],  [noexcept]

Returns the total number of characters that the string can hold before needing to allocate more memory ✨. Think of it as the size of the closet, not the number of outfits currently in it.

Referenced by __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::push_back(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::shrink_to_fit().

🥇 `cbegin()` — read-only, first character

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::cbegin ()
    const [inline],  [noexcept]

Returns a read-only (constant) iterator that points to the first character in the string 🫶. Look, don't touch.

🏁 `cend()` — read-only, one past the end

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::cend ()
    const [inline],  [noexcept]

Returns a read-only (constant) iterator that points one past the last character in the string 🌸. Classic end-of-range icon behavior.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

🧹 `clear()` — the reset button

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::clear ()
    [inline],  [noexcept]

Erases the string, making it empty 🎀. Fresh start energy. We love a blank slate.

⚖️ `compare(const __versa_string& __str)` — the O.G. comparison

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str) const
    [inline]

Compare to a string.

Parameters

__str — String to compare against.

Returns

Integer < 0, 0, or > 0.

So here's the tea ☕: you get an integer < 0 if this string is ordered before __str, 0 if their values are equivalent, or > 0 if this string is ordered after __str. It determines the effective length rlen of the strings to compare as the smallest of size() and str.size(). Then it compares the two strings by calling traits::compare(data(), str.data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first ✨.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::data(), std::min(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by __gnu_cxx::operator<(), __gnu_cxx::operator<(), __gnu_cxx::operator<(), __gnu_cxx::operator<=(), __gnu_cxx::operator<=(), __gnu_cxx::operator<=(), __gnu_cxx::operator>(), __gnu_cxx::operator>(), __gnu_cxx::operator>(), __gnu_cxx::operator>=(), __gnu_cxx::operator>=(), and __gnu_cxx::operator>=(). (Yes, three of each — the operators are thriving.)

⚖️ `compare(const _CharT * __s)` — string vs. C string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (const _CharT * __s) const

Compare to a C string 💜.

Parameters

__s — C string to compare against.

Returns

Integer < 0, 0, or > 0.

Returns an integer < 0 if this string is ordered before __s, 0 if their values are equivalent, or > 0 if this string is ordered after __s. Determines the effective length rlen of the strings to compare as the smallest of size() and the length of a string constructed from __s. The function then compares the two strings by calling traits::compare(data(),s,rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first 🌈.

References std::min().

⚖️ `compare(size_type __pos, size_type n, const versa_string& __str)` — substring vs. string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (size_type __pos, size_type __n, const __versa_string< _CharT, _Traits,
    _Alloc, _Base > & __str) const

Compare substring to a string 🦋.

Parameters

__pos — Index of first character of substring.
__n — Number of characters in substring.
__str — String to compare against.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n characters starting at __pos. Returns an integer < 0 if the substring is ordered before __str, 0 if their values are equivalent, or > 0 if the substring is ordered after __str. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and __str.size(). The function then compares the two strings by calling traits::compare(substring.data(),str.data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first 💫.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::data(), std::min(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

⚖️ `compare(size_type __pos, size_type __n1, const _CharT * __s)` — substring vs. C string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (size_type __pos, size_type __n1, const _CharT * __s) const

Compare substring to a C string 🍓.

Parameters

__pos — Index of first character of substring.
__n1 — Number of characters in substring.
__s — C string to compare against.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n1 characters starting at __pos. Returns an integer < 0 if the substring is ordered before __s, 0 if their values are equivalent, or > 0 if the substring is ordered after __s. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and the length of a string constructed from __s. The function then compares the two string by calling traits::compare(substring.data(),s,rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first 🌸.

References std::min().

⚖️ `compare(size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)`

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)
    const

Compare substring against a character array 🧚.

Parameters

__pos — Index of first character of substring.
__n1 — Number of characters in substring.
__s — character array to compare against.
__n2 — Number of characters of s.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n1 characters starting at __pos. Form a string from the first __n2 characters of __s. Returns an integer < 0 if this substring is ordered before the string from __s, 0 if their values are equivalent, or > 0 if this substring is ordered after the string from __s. Determines the effective length rlen of the strings to compare as the smallest of the length of the substring and __n2. The function then compares the two strings by calling traits::compare(substring.data(),__s,rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first 👑.

🚨 NB: __s must have at least n2 characters, \0 has no special meaning. Like, it does not stop at the null. Don't come crying to me when you read past your buffer, bestie. 💀

References std::min().

⚖️ `compare(size_type __pos1, size_type n1, const versa_string& __str, size_type __pos2, size_type __n2)` — substring vs. substring, the double-feature

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> int
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare
    (size_type __pos1, size_type __n1, const __versa_string< _CharT,
    _Traits, _Alloc, _Base > & __str, size_type __pos2, size_type __n2)
    const

Compare substring to a substring ✨.

Parameters

__pos1 — Index of first character of substring.
__n1 — Number of characters in substring.
__str — String to compare against.
__pos2 — Index of first character of substring of str.
__n2 — Number of characters in substring of str.

Returns

Integer < 0, 0, or > 0.

Form the substring of this string from the __n1 characters starting at __pos1. Form the substring of __str from the __n2 characters starting at __pos2. Returns an integer < 0 if this substring is ordered before the substring of __str, 0 if their values are equivalent, or > 0 if this substring is ordered after the substring of __str. Determines the effective length rlen of the strings to compare as the smallest of the lengths of the substrings. The function then compares the two strings by calling traits::compare(substring.data(),str.substr(pos2,n2).data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first 💅.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::data(), and std::min().

📤 `copy(_CharT * __s, size_type __n, size_type __pos = 0)` — dump it into a C string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string< _CharT,
    _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
    _Traits, _Alloc, _Base >::copy (_CharT * __s, size_type __n, size_type
    __pos = 0) const

Copy substring into C string 🎀.

Parameters

__s — C string to copy value into.
__n — Number of characters to copy.
__pos — Index of first character to copy.

Returns

Number of characters actually copied.

Exceptions

std::out_of_range — If pos > size().

Copies up to __n characters starting at __pos into the C string s. If __pos is greater than size(), out_of_range is thrown 😭. That's the whole vibe: you get back how many characters actually got copied, so check your receipt.

🔄 `crbegin()` — read-only, last character first

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reverse_iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::crbegin ()
    const [inline],  [noexcept]

Returns a read-only (constant) reverse iterator that points to the last character in the string. Iteration is done in reverse element order 🦋. Main character energy: enters from the back.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::end().

🔄 `crend()` — read-only, one before the first

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reverse_iterator
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::crend ()
    const [inline],  [noexcept]

Returns a read-only (constant) reverse iterator that points to one before the first character in the string. Iteration is done in reverse element order 🌈. It's the mirror-universe cend(), and she's slaying.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::begin().

🫶 `data()`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
const _CharT *
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::data() const
[inline] [noexcept]

Okay bestie, this one hands you a const pointer to the contents ✨ — basically a handle straight into the internal data. And like...

⚠️ Do NOT modify it. The manpage literally says "Do not modify or dire things may happen." Dire!! 😭 That's not a vibe check, that's a threat. Hands off the internals, periodt.

Referenced by: __gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::compare() (three times — all the compare() overloads), ::find(), ::find_first_not_of(), ::find_first_of(), ::find_last_of(), and __gnu_cxx::operator==() (both overloads).

🦋 `empty()`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
bool
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::empty() const
[inline] [noexcept]

Returns true if the string is empty — and it's exactly the same thing as *this == '', no cap 💅 So like, it's giving "is there anything in here or nah".

References: ::size().

🌸 `end()` — the `const` one

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
const_iterator
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::end() const
[inline] [noexcept]

Gives you a read-only (constant) iterator pointing one past the last character in the string 👑 Classic "the end isn't actually the last character" situation, iykyk.

References: ::size().

🎀 `end()` — the non-`const` one

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
iterator
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::end()
[inline] [noexcept]

Same deal but you get a read/write iterator pointing one past the last character. Only extra detail: it unshares the string 🙈 (yes, before you get to poke at it, it makes sure the string is yours alone — main character energy, no sharing).

References: ::size().

Referenced by: ::crbegin(), ::rbegin(), and ::rbegin() again (there are two rbegin() overloads, bestie).

💜 `erase(const_iterator __first, const_iterator __last)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
iterator
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::erase(
    const_iterator __first, const_iterator __last) [inline]

Remove a whole range of characters 🔥

Parameters

__first — iterator referencing the first character to remove.
__last — iterator referencing the end of the range.

Returns: an iterator referencing the location of the first character after removal.

It removes the characters in the range [first,last) from this string. And the glow-up safety guarantee: the value of the string doesn't change if an error is thrown ✨

🧚 `erase(const_iterator __position)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
iterator
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::erase(
    const_iterator __position) [inline]

Just one character, singular, no ensemble 💅

Parameters

__position — iterator referencing the character to remove.

Returns: an iterator referencing the same location after removal.

Removes the character at __position from this string. And again, same promise: the value of the string doesn't change if an error is thrown 🫶

⭐ `erase(size_type __pos = 0, size_type __n = npos)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
__versa_string &
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::erase(
    size_type __pos = 0, size_type __n = npos) [inline]

The index-based erase, and it returns a reference to this string so you can keep chaining 😌

Parameters

__pos — index of first character to remove (default 0).
__n — number of characters to remove (default: the remainder).

Returns: reference to this string.

Exceptions

std::out_of_range — if __pos is beyond the end of this string.

So here's the tea: removes __n characters from this string starting at __pos. The length of the string is reduced by __n. If there are < __n characters to remove, the remainder of the string is truncated. If __p is beyond end of string, out_of_range is thrown 🚨 And (say it with me) the value of the string doesn't change if an error is thrown.

Referenced by: std::getline().

🌈 `find(_CharT __c, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::find(
    _CharT __c, size_type __pos = 0) const [noexcept]

Find the position of a single character 🔍

Parameters

__c — character to locate.
__pos — index of character to search from (default 0).

Returns: index of the first occurrence.

Starting from __pos, it searches forward for __c within this string. Found it? Returns the index where it was found. Not found? Returns npos 💀

🍓 `find(const __versa_string& __str, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::find(
    const __versa_string<_CharT, _Traits, _Alloc, _Base> & __str,
    size_type __pos = 0) const [inline] [noexcept]

Same hunt, but for a whole string 👑

Parameters

__str — string to locate.
__pos — index of character to search from (default 0).

Returns: index of the start of the first occurrence.

Starting from __pos, searches forward for the value of __str within this string. If found, returns the index where it begins. If not found, returns npos.

References: ::data(), ::find(), and ::size().

🎀 `find(const _CharT * __s, size_type __pos, size_type __n)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::find(
    const _CharT * __s, size_type __pos, size_type __n) const

Now we're finding a C substring — notice there's no default for __pos or __n here, bestie, you're giving it all three 🫡

Parameters

__s — C string to locate.
__pos — index of character to search from.
__n — number of characters from __s to search for.

Returns: index of the start of the first occurrence.

Starting from __pos, searches forward for the first __n characters in __s within this string. If found, returns the index where it begins. If not found, returns npos.

Referenced by: ::find(), ::find(), and ::find_first_of().

✨ `find(const _CharT * __s, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::find(
    const _CharT * __s, size_type __pos = 0) const [inline]

The C-string version, now with the __pos = 0 default restored, we love convenience 💅

Parameters

__s — C string to locate.
__pos — index of character to search from (default 0).

Returns: index of the start of the first occurrence.

Starting from __pos, searches forward for the value of __s within this string. If found, returns the index where it begins. If not found, returns npos.

References: ::find().

💀 `find_first_not_of(_CharT __c, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::
find_first_not_of(_CharT __c, size_type __pos = 0) const [noexcept]

The opposite hunt — find the position of a different character 🙈

Parameters

__c — character to avoid.
__pos — index of character to search from (default 0).

Returns: index of the first occurrence.

Starting from __pos, searches forward for a character other than __c within this string. Found one? Returns the index where it was found. None? Returns npos.

🧚 `find_first_not_of(const __versa_string& __str, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::
find_first_not_of(
    const __versa_string<_CharT, _Traits, _Alloc, _Base> & __str,
    size_type __pos = 0) const [inline] [noexcept]

Find a character that is not in the given string 👑

Parameters

__str — string containing characters to avoid.
__pos — index of character to search from (default 0).

Returns: index of the first occurrence.

Starting from __pos, searches forward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.

References: ::data(), ::find_first_not_of(), and ::size().

Referenced by: ::find_first_not_of() and ::find_first_not_of() (two more overloads, it's a whole family 🫶).

🔥 `find_first_not_of(const _CharT * __s, size_type __pos, size_type __n)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::
find_first_not_of(
    const _CharT * __s, size_type __pos, size_type __n) const

Find a character not in a C substring — again, no defaults for __pos and __n, you're on your own for those two 😭

Parameters

__s — C string containing characters to avoid.
__pos — index of character to search from.
__n — number of characters from s to consider.

Returns: index of the first occurrence.

Starting from __pos, searches forward for a character not contained in the first __n characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

🌸 `find_first_not_of(const _CharT * __s, size_type __pos = 0)`

template<typename _CharT, typename _Traits, typename _Alloc,
         template<typename, typename, typename> class _Base>
size_type
__gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>::
find_first_not_of(const _CharT * __s, size_type __pos = 0) const
[inline]

Find a character not in a C string, with the default __pos = 0 back where it belongs ✨

Parameters

__s — C string containing characters to avoid.
__pos — index of character to search from (default 0).

Returns: index of the first occurrence.

Starting from __pos, searches forward for a character not contained in __s within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_not_of().

💅 `find_first_of` — bestie, where's the first match?

🌸 `find_first_of` (`_CharT __c`, `size_type __pos = 0`) — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_first_of (_CharT __c, size_type __pos = 0) const [inline],
       [noexcept]

Find position of a character. Literally just one lil char hunt 🔍

Parameters

__c — the character to locate, i.e. the one you're simping for.
__pos — index of the character to search from (default 0).

Returns — index of first occurrence. That's it, that's the whole vibe.

Starting from __pos, it searches forward for the character __c within this string. If found, returns the index where it was found. If not found, returns npos (sad girl hours 😭).

Note: equivalent to find(c, pos).

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find().

🦋 `find_first_of` (`const __versa_string& __str`, `size_type __pos = 0`) — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_first_of (const __versa_string< _CharT, _Traits, _Alloc, _Base >
       & __str, size_type __pos = 0) const [inline],  [noexcept]

Find position of a character of string. Now we're hunting for any one of a whole squad of characters ✨

Parameters

__str — the string containing the characters to locate.
__pos — index of the character to search from (default 0).

Returns — index of first occurrence.

Starting from __pos, it searches forward for one of the characters of __str within this string. Found one? Returns the index. Nope, nothing? Returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::data(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_of(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_of(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_of().

🎀 `find_first_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> __versa_string< _CharT,
       _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
       _Traits, _Alloc, _Base >::find_first_of (const _CharT * __s, size_type
       __pos, size_type __n) const

Find position of a character of C substring. Same energy, but you're telling it exactly how many characters to look at 💅

Parameters

__s — string containing the characters to locate.
__pos — index of the character to search from.
__n — number of characters from s to search for.

Returns — index of first occurrence.

Starting from __pos, it searches forward for one of the first __n characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

🧚 `find_first_of` (`const _CharT* __s`, `size_type __pos = 0`) — `const`, `[inline]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_first_of (const _CharT * __s, size_type __pos = 0) const
       [inline]

Find position of a character of C string. The classic no-count version, she's convenient like that 🫶

Parameters

__s — string containing the characters to locate.
__pos — index of the character to search from (default 0).

Returns — index of first occurrence.

Starting from __pos, it searches forward for one of the characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_of().

👑 `find_last_not_of` — the "anything but that" girlie

💜 `find_last_not_of` (`_CharT __c`, `size_type __pos = npos`) — `const`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> __versa_string< _CharT,
       _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
       _Traits, _Alloc, _Base >::find_last_not_of (_CharT __c, size_type __pos
       = npos) const [noexcept]

Find last position of a different character. She's looking backwards and she's picky — not this one, literally anything else bestie 🙈

Parameters

__c — character to avoid. (We don't do that here.)
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for a character other than __c within this string. If found, returns the index where it was found. If not found, returns npos.

⭐ `find_last_not_of` (`const __versa_string& __str`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_last_not_of (const __versa_string< _CharT, _Traits, _Alloc,
       _Base > & __str, size_type __pos = npos) const [inline],  [noexcept]

Find last position of a character not in string. Whole-string avoid list, we love a boundary 😌

Parameters

__str — string containing the characters to avoid.
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for a character not contained in __str within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_not_of().

Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_not_of(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_not_of().

🌈 `find_last_not_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> __versa_string< _CharT,
       _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
       _Traits, _Alloc, _Base >::find_last_not_of (const _CharT * __s,
       size_type __pos, size_type __n) const

Find last position of a character not in C substring. Bounded avoid-list, very demure, very mindful 🎀

Parameters

__s — C string containing the characters to avoid.
__pos — index of the character to search back from.
__n — number of characters from s to consider.

Returns — index of last occurrence.

Starting from __pos, it searches backward for a character not contained in the first __n characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

🍓 `find_last_not_of` (`const _CharT* __s`, `size_type __pos = npos`) — `const`, `[inline]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_last_not_of (const _CharT * __s, size_type __pos = npos) const
       [inline]

Find last position of a character not in C string. The low-effort version — just hand her the C string and go ✨

Parameters

__s — C string containing the characters to avoid.
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for a character not contained in __s within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_not_of().

🔥 `find_last_of` — searching backwards for the moment

🌸 `find_last_of` (`_CharT __c`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_last_of (_CharT __c, size_type __pos = npos) const [inline],
       [noexcept]

Find last position of a character. One char, but from the back 💅

Parameters

__c — character to locate.
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for __c within this string. If found, returns the index where it was found. If not found, returns npos.

Note: equivalent to rfind(c, pos).

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind().

🦋 `find_last_of` (`const __versa_string& __str`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_last_of (const __versa_string< _CharT, _Traits, _Alloc, _Base >
       & __str, size_type __pos = npos) const [inline],  [noexcept]

Find last position of a character of string. Backwards hunt through a whole squad 🎀

Parameters

__str — string containing the characters to locate.
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::data(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of().

🧚 `find_last_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> __versa_string< _CharT,
       _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
       _Traits, _Alloc, _Base >::find_last_of (const _CharT * __s, size_type
       __pos, size_type __n) const

Find last position of a character of C substring. Backwards, but only within the first __n chars of __s — boundaries are hot 🔥

Parameters

__s — C string containing the characters to locate.
__pos — index of the character to search back from.
__n — number of characters from s to search for.

Returns — index of last occurrence.

Starting from __pos, it searches backward for one of the first __n characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

⭐ `find_last_of` (`const _CharT* __s`, `size_type __pos = npos`) — `const`, `[inline]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> size_type
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
       >::find_last_of (const _CharT * __s, size_type __pos = npos) const
       [inline]

Find last position of a character of C string. Give her the whole C string, she'll do the rest 🫶

Parameters

__s — C string containing the characters to locate.
__pos — index of the character to search back from (default end).

Returns — index of last occurrence.

Starting from __pos, it searches backward for one of the characters of __s within this string. If found, returns the index where it was found. If not found, returns npos.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of().

🎀 `front` — the first character, main character energy

💖 `front` — `const`, `[inline]`, `[noexcept]`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> const_reference
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::front ()
       const [inline],  [noexcept]

Returns a read-only (constant) reference to the data at the first element of the string. Look, don't touch 🔒✨

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]().

🔓 `front`

   template<typename _CharT , typename _Traits , typename _Alloc , template<
       typename, typename, typename > class _Base> reference
       __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::front ()
       [inline],  [noexcept]

Returns a read/write reference to the data at the first element of the string. Now you can touch — go off, edit that first character 💅🔥

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]().

(that trailing bit is just the receipts from the entry right above it, bestie — it references operator[], slay 💅)

`get_allocator` 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> allocator_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
    >::get_allocator () const

[inline], [noexcept]

Returns a copy of the allocator that was used to construct this string. That's the whole thing — a little allocator souvenir 💖

`insert` — one single character 🌸

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> iterator
    __gnu_cxx::__versa_string< _CharT, _Traits , _Alloc, _Base >::insert
    (const_iterator __p, _CharT __c)

[inline]

Inserts exactly one character. Lowkey the simplest insert there is ✨

Parameters

__p — iterator referencing the position in the string to insert at.
__c — the character to insert.

Returns

Iterator referencing the newly inserted char. 🫶

Exceptions

std::length_error — if the new length exceeds max_size().

So: it inserts __c at the position referenced by __p. If adding that character makes the length exceed max_size(), length_error gets thrown. And if __p is beyond end of string, out_of_range is thrown. Either way, the value of the string doesn't change if an error is thrown — she's not messy like that 💅

`insert` — a whole range of characters 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> template<class
    _InputIterator , typename  = std::_RequireInputIter<_InputIterator>>
    iterator __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
    >::insert (const_iterator __p, _InputIterator __beg, _InputIterator
    __end)

[inline]

Inserts a range of characters. Group-chat energy: bring the whole squad in 😌

Parameters

__p — const_iterator referencing the location in the string to insert at.
__beg — start of range.
__end — end of range.

Returns

Iterator referencing the first inserted char.

Exceptions

std::length_error — if the new length exceeds max_size().

It inserts the characters in the range [beg,end). If adding those characters makes the length exceed max_size(), length_error is thrown. And bestie, the value of the string doesn't change if an error is thrown — no half-finished edits, periodt.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

`insert` — multiple characters, iterator edition 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> iterator
    __gnu_cxx::__versa_string< _CharT, _Traits , _Alloc, _Base >::insert
    (const_iterator __p, size_type __n, _CharT __c)

[inline]

Inserts multiple copies of one character. It's giving "copy paste but make it C++" 💖

Parameters

__p — const_iterator referencing the location in the string to insert at.
__n — number of characters to insert.
__c — the character to insert.

Returns

Iterator referencing the first inserted char.

Exceptions

std::length_error — if the new length exceeds max_size().

Inserts __n copies of character __c, starting at the position referenced by iterator __p. If adding characters causes the length to exceed max_size(), length_error is thrown. And yep — the value of the string doesn't change if an error is thrown.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

Referenced by __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert().

`insert` — initializer_list edition 🍓

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> iterator
    __gnu_cxx::__versa_string< _CharT, _Traits , _Alloc, _Base >::insert
    (const_iterator __p, std::initializer_list< _CharT > __l)

[inline]

Inserts an initializer_list of characters. Curly braces girlies, this one's for you ✨

Parameters

__p — const_iterator referencing the location in the string to insert at.
__l — the initializer_list of characters to insert.

Returns

Iterator referencing the first inserted char.

Exceptions

std::length_error — if the new length exceeds max_size().

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert().

`insert` — a C string goes in 🌈

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert
    (size_type __pos, const _CharT * __s)

[inline]

Inserts a C string. Classic, iconic, no notes 💀

Parameters

__pos — iterator referencing the location in the string to insert at.
__s — the C string to insert.

Returns

Reference to this string.

Exceptions

std::length_error — if the new length exceeds max_size().
std::out_of_range — if __pos is beyond the end of this string.

It inserts the first __n characters of __s, starting at __pos. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos is beyond end(), out_of_range is thrown. And fr fr — the value of the string doesn't change if an error is thrown.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

`insert` — a C substring, with a length this time 🧚

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert
    (size_type __pos, const _CharT * __s, size_type __n)

[inline]

Inserts a C substring. Same vibe, but you tell her exactly how many chars to take 🎀

Parameters

__pos — iterator referencing the location in the string to insert at.
__s — the C string to insert.
__n — the number of characters to insert.

Returns

Reference to this string.

Exceptions

std::length_error — if the new length exceeds max_size().
std::out_of_range — if __pos is beyond the end of this string.

Inserts the first __n characters of __s, starting at __pos. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos is beyond end(), out_of_range is thrown. And again, bestie: the value of the string doesn't change if an error is thrown 💜

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

`insert` — n copies of a char at an index 👑

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert
    (size_type __pos, size_type __n, _CharT __c)

[inline]

Insert multiple characters, but this time you're working with an index instead of an iterator. Main character energy 🔥

Parameters

__pos — index in string to insert at.
__n — number of characters to insert.
__c — the character to insert.

Returns

Reference to this string.

Exceptions

std::length_error — if the new length exceeds max_size().
std::out_of_range — if __pos is beyond the end of this string.

Inserts __n copies of character __c, starting at index __pos. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos > length(), out_of_range is thrown. And yup — the value of the string doesn't change if an error is thrown ✨

`insert` — jam a whole string in there 💖

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert
    (size_type __pos1, const __versa_string< _CharT, _Traits, _Alloc, _Base
    > & __str)

[inline]

Inserts the value of a string. String-ception, we love to see it 🦋

Parameters

__pos1 — iterator referencing the location in the string to insert at.
__str — the string to insert.

Returns

Reference to this string.

Exceptions

std::length_error — if the new length exceeds max_size().

Inserts the value of __str, starting at __pos1. If adding characters causes the length to exceed max_size(), length_error is thrown. And obviously — the value of the string doesn't change if an error is thrown 💅

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

`insert` — the full substring situation 🌸

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert
    (size_type __pos1, const __versa_string< _CharT, _Traits, _Alloc, _Base
    > & __str, size_type __pos2, size_type __n)

[inline]

Inserts a substring — the most specific of the insert girlies and honestly? Obsessed 🎀

Parameters

__pos1 — iterator referencing the location in the string to insert at.
__str — the string to insert.
__pos2 — start of characters in str to insert.
__n — number of characters to insert.

Returns

Reference to this string.

Exceptions

std::length_error — if the new length exceeds max_size().
std::out_of_range — if __pos1 > size() or __pos2 > __str.size().

Starting at __pos1, insert __n character of __str beginning with __pos2. If adding characters causes the length to exceed max_size(), length_error is thrown. If __pos1 is beyond the end of this string, or __pos2 is beyond the end of __str, out_of_range is thrown. And yes, one more time for the people in the back: the value of the string doesn't change if an error is thrown 👑

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

`length` 🧚

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::length ()
    const

[inline], [noexcept]

Returns the number of characters in the string — not including any null-termination. That null terminator is not invited to the count 💅

`max_size` ⭐

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::max_size ()
    const

[inline], [noexcept]

Returns the size() of the largest possible string. Big "how much can she hold" energy 🌈

Referenced by std::getline().

`operator+=` — append a character 🍓

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=
    (_CharT __c)

[inline]

Appends a single character. Tiny little add, big little slay ✨

Parameters

__c — the character to append.

Returns

Reference to this string.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::push_back().

`operator+=` — append a string 🫶

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=
    (const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str)

[inline]

Appends a string to this string. Two strings becoming one, it's giving soulmate behaviour 💖

Parameters

__str — the string to append.

Returns

Reference to this string.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append().

`operator+=` — append a C string 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=
    (const _CharT * __s)

[inline]

Appends a C string. The OG char pointer gets to join the party too 😌

Parameters

__s — the C string to append.

Returns

Reference to this string.

References __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append().

💅 `operator+=` (the `initializer_list` one)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=
(std::initializer_list< _CharT > __l) [inline]

okay so this one just appends an entire initializer_list of characters onto your string, bestie ✨

Parameters — __l: the initializer_list of characters you're slapping on the end.
Returns — a reference to this string. 🫶

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append().

🚚 `operator=` (move assignment)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=
(__versa_string< _CharT, _Traits, _Alloc, _Base > && __str) [inline],
[noexcept]

the string move assignment operator, and she's noexcept so she's not about to throw hands 😌

Parameters — __str: the source string.

the contents of __str get moved into this string — without copying, periodt. and after that, __str is described as a valid, but unspecified string. (translation: don't go poking at it expecting the old contents, she's been through something 🙈)

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::swap().

🔤 `operator=` (single character)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=
(_CharT __c) [inline]

set the value to a string of length 1. literally one character era 💅

Parameters — __c: the source character.

assigning to a character makes this string length 1, and (*this)[0] == __c. no cap.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign().

📋 `operator=` (copy assignment)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=
(const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str) [inline]

assign the value of str to this string. the classic. the icon. 🌸

Parameters — __str: the source string.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign().

🪢 `operator=` (C string)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=
(const _CharT * __s) [inline]

copy the contents of __s into this string 🦋

Parameters — __s: source null-terminated string.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign().

🎀 `operator=` (`initializer_list`)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=
(std::initializer_list< _CharT > __l) [inline]

sets the value to a string constructed from an initializer list ✨

Parameters — __l: std::initializer_list.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign().

🔍 `operator[]` (const version)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reference
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]
(size_type __pos) const [inline], [noexcept]

subscript access to the data inside the string — the read-only, behave-yourself version 👑

Parameters — __pos: the index of the character you want to access.
Returns — a read-only (constant) reference to that character.

this operator gives you easy, array-style, data access. but — and this is the important bit, bestie — data access with this operator is unchecked, and out_of_range lookups are not defined. 😭 (for checked lookups, go see at().)

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::front(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::front().

🔓 `operator[]` (the read/write one)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> reference
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]
(size_type __pos) [inline], [noexcept]

subscript access to the data inside the string, but this time you get to write 💅

Parameters — __pos: the index of the character you're accessing.
Returns — a read/write reference to the character.

same deal as above: easy, array-style, data access. and again — data access with this operator is unchecked, out_of_range lookups are not defined, and for checked lookups you want at(). one extra thing: this version unshares the string 🔥

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

✂️ `pop_back`

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::pop_back ()
[inline]

removes the last character. and heads up: the string must be non-empty ⚠️ don't come crying to me if you pop an empty string, I warned you.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

➕ `push_back`

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::push_back
(_CharT __c) [inline]

appends a single character. tiny little addition, huge slay 🎀

Parameters — __c: the character to append.

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::capacity(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

Referenced by: __gnu_cxx::operator+(), __gnu_cxx::operator+(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator+=().

🔙 `rbegin` (const)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reverse_iterator
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rbegin ()
const [inline], [noexcept]

returns a read-only (constant) reverse iterator pointing at the last character in the string. iteration happens in reverse element order, which is exactly the vibe 🦋

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::end().

🔄 `rbegin` (read/write)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> reverse_iterator
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rbegin ()
[inline], [noexcept]

returns a read/write reverse iterator pointing at the last character in the string. iteration is in reverse element order. and yes — it unshares the string 💅

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::end().

🏁 `rend` (const)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const_reverse_iterator
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rend ()
const [inline], [noexcept]

returns a read-only (constant) reverse iterator pointing to one before the first character in the string. iteration's in reverse element order, as always ✨

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::begin().

🎬 `rend` (read/write)

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> reverse_iterator
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rend ()
[inline], [noexcept]

returns a read/write reverse iterator pointing to one before the first character in the string. reverse element order, obviously. and it unshares the string 🌸

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::begin().

🩹 `replace` — range with range

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> template<class
_InputIterator , typename = std::_RequireInputIter<_InputIterator>>
__versa_string & __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
>::replace (const_iterator __i1, const_iterator __i2, _InputIterator __k1,
_InputIterator __k2) [inline]

replace a range of characters with another range — the swap-your-whole-situation move 😌

Parameters
- __i1: iterator referencing the start of the range to replace.
- __i2: iterator referencing the end of the range to replace.
- __k1: iterator referencing the start of the range to insert.
- __k2: iterator referencing the end of the range to insert.
Returns — a reference to this string.
Exceptions — std::length_error if the new length exceeds max_size().

here's the tea: it removes the characters in the range [i1,i2), and in place the characters in the range [k1,k2) get inserted. if the resulting length exceeds max_size(), length_error gets thrown. and good news — the value of the string doesn't change if an error is thrown 🫶

🩹 `replace` — range with string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
(const_iterator __i1, const_iterator __i2, const __versa_string< _CharT,
_Traits, _Alloc, _Base > & __str) [inline]

replace a range of characters with an entire string 👑

Parameters
- __i1: iterator referencing the start of the range to replace.
- __i2: iterator referencing the end of the range to replace.
- __str: the string value to insert.
Returns — a reference to this string.
Exceptions — std::length_error if the new length exceeds max_size().

it removes the characters in [i1,i2) and, in place, inserts the value of __str. if the result is longer than max_size(), length_error is thrown. the string's value stays untouched if an error is thrown 💖

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace(), and __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size().

🩹 `replace` — range with C string

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
(const_iterator __i1, const_iterator __i2, const _CharT * __s) [inline]

replace a range of characters with a C string ✨

Parameters
- __i1: iterator referencing the start of the range to replace.
- __i2: iterator referencing the end of the range to replace.
- __s: the C string value to insert.
Returns — a reference to this string.
Exceptions — std::length_error if the new length exceeds max_size().

kicks out the characters in [i1,i2) and drops in the characters of __s in their place. over max_size()? that's a length_error. and if an error's thrown, the string value does not change 🙈

References: __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

🩹 `replace` — range with C substring

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
(const_iterator __i1, const_iterator __i2, const _CharT * __s, size_type
__n) [inline]

replace a range of characters with a C substring — yes, she takes an __n too, she's thorough 🎀

Parameters 🌸

__i1 — iterator pointing at the start of the range you're replacing. Like, where the swap-out begins, bestie.
__i2 — iterator pointing at the end of that range. One past the last character getting yeeted.
__s — the C string value you're inserting. 🎀
__n — number of characters from s to insert.

Returns 💖

Reference to this string. Chaining vibes, fr fr.

Exceptions 😭

std::length_error — if the new length exceeds max_size().

Removes the characters in the range [i1,i2). In place, the first n characters of __s are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

✨ another `replace` overload: iterator range + count + character ✨

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (const_iterator __i1, const_iterator __i2, size_type __n, _CharT __c)
    [inline]

Replace range of characters with multiple characters. Iconic behavior, no cap.

Parameters 🧚

__i1 — iterator referencing start of range to replace.
__i2 — iterator referencing end of range to replace.
__n — number of characters to insert.
__c — character to insert.

Returns 🫶

Reference to this string.

Exceptions 💀

std::length_error — if new length exceeds max_size().

Removes the characters in the range [i1,i2). In place, __n copies of __c are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

🌈 `replace` overload: iterator range + `initializer_list` 🌈

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (const_iterator __i1, const_iterator __i2, std::initializer_list< _CharT
    > __l) [inline]

Replace range of characters with initializer_list. Very cute, very curated. 🎀

Parameters 🌸

__i1 — iterator referencing start of range to replace.
__i2 — iterator referencing end of range to replace.
__l — the initializer_list of characters to insert.

Returns 💖

Reference to this string.

Exceptions 😭

std::length_error — if new length exceeds max_size().

Removes the characters in the range [i1,i2). In place, characters in the range [k1,k2) are inserted. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

🦋 `replace` overload: index + count + another string 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (size_type __pos, size_type __n, const __versa_string< _CharT, _Traits,
    _Alloc, _Base > & __str) [inline]

Replace characters with value from another string. It's giving copy-paste but make it C++.

Parameters 🌟

__pos — index of first character to replace.
__n — number of characters to be replaced.
__str — string to insert.

Returns 💅

Reference to this string.

Exceptions 😭

std::out_of_range — if __pos is beyond the end of this string.
std::length_error — if new length exceeds max_size().

Removes the characters in the range [pos,pos+n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size()

Referenced by (yes, all of these, no cap) 🔥

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()

🍓 `replace` overload: index + count + C string 🍓

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (size_type __pos, size_type __n1, const _CharT * __s) [inline]

Replace characters with value of a C string. Very main character, very null-terminated. ✨

Parameters 🎀

__pos — index of first character to replace.
__n1 — number of characters to be replaced.
__s — C string to insert.

Returns 💖

Reference to this string.

Exceptions 😭

std::out_of_range — if __pos > size().
std::length_error — if new length exceeds max_size().

Removes the characters in the range [pos,pos + n1) from this string. In place, the characters of __s are inserted. If pos is beyond end of string, out_of_range is thrown. If the length of result exceeds max_size(), length_error is thrown.

The value of the string doesn't change if an error is thrown.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

💜 `replace` overload: index + count + C substring + count 💜

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)
    [inline]

Replace characters with value of a C substring. It's giving "only take the first few chars, bestie." 🦋

Parameters 🌸

__pos — index of first character to replace.
__n1 — number of characters to be replaced.
__s — C string to insert.
__n2 — number of characters from __s to use.

Returns 🫶

Reference to this string.

Exceptions 😭

std::out_of_range — if __pos1 > size().
std::length_error — if new length exceeds max_size().

Removes the characters in the range [pos,pos + n1) from this string. In place, the first __n2 characters of __s are inserted, or all of __s if __n2 is too large. If __pos is beyond end of string, out_of_range is thrown. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

⭐ `replace` overload: index + counts + character ⭐

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (size_type __pos, size_type __n1, size_type __n2, _CharT __c) [inline]

Replace characters with multiple characters. Same char, multiple times. We love a repeat moment. 💅

Parameters 🌟

__pos — index of first character to replace.
__n1 — number of characters to be replaced.
__n2 — number of characters to insert.
__c — character to insert.

Returns 💖

Reference to this string.

Exceptions 😭

std::out_of_range — if __pos > size().
std::length_error — if new length exceeds max_size().

Removes the characters in the range [pos,pos + n1) from this string. In place, __n2 copies of __c are inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

🌈 `replace` overload: index + count + string + index + count 🌈

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string &
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace
    (size_type __pos1, size_type __n1, const __versa_string< _CharT,
    _Traits, _Alloc, _Base > & __str, size_type __pos2, size_type __n2)
    [inline]

Replace characters with value from another string. This one takes a whole little slice of __str, iykyk.

Parameters 🧚

__pos1 — index of first character to replace.
__n1 — number of characters to be replaced.
__str — string to insert.
__pos2 — index of first character of str to use.
__n2 — number of characters from str to use.

Returns 🫶

Reference to this string.

Exceptions 😭

std::out_of_range — if __pos1 > size() or __pos2 > str.size().
std::length_error — if new length exceeds max_size().

Removes the characters in the range [pos1,pos1 + n) from this string. In place, the value of __str is inserted. If __pos is beyond end of string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace().

🎀 `reserve` — preallocate like a planner 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::reserve
    (size_type __res_arg = 0) [inline]

Attempt to preallocate enough memory for specified number of characters. Future-proofing vibes, honestly. ✨

Parameters 🌸

__res_arg — number of characters required.

Exceptions 😭

std::length_error — if __res_arg exceeds max_size().

This function attempts to reserve enough memory for the string to hold the specified number of characters. If the number requested is more than max_size(), length_error is thrown.

The advantage of this function is that if optimal code is a necessity and the user can determine the string length that will be required, the user can reserve the memory in advance, and thus prevent a possible reallocation of memory and copying of string data.

Referenced by 🔥

__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::shrink_to_fit()

🦋 `resize` — change the character count 🦋

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::resize
    (size_type __n) [inline]

Resizes the string to the specified number of characters. Glow-up or shrink-down, either way. 💖

Parameters 🌟

__n — number of characters the string should contain.

This function will resize the string to the specified length. If the new size is smaller than the string's current size the string is truncated, otherwise the string is extended and new characters are default-constructed. For basic types such as char, this means setting them to 0.

References 🔗

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::resize().

okay bestie, we're in the final stretch of the member functions and it's giving completionist energy ✨ let's close this out 💅

`resize` — the glow-up/glow-down 💇‍♀️

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::resize
    (size_type __n, _CharT __c)

Resizes the string to the specified number of characters. iconic.

Parameters

__n — number of characters the string should contain.
__c — character to fill any new elements.

This function will resize the string to the specified number of characters. If the number is smaller than the string's current size the string is truncated, otherwise the string is extended and new elements are set to __c.

Referenced by __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::resize(). (yes, it references itself, main character energy fr fr)

`rfind` (char) — last seen at the function, literally 🔍

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string< _CharT,
    _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
    _Traits, _Alloc, _Base >::rfind (_CharT __c, size_type __pos = npos)
    const [noexcept]

Find last position of a character.

Parameters

__c — character to locate.
__pos — index of character to search back from (default end).

Returns

Index of last occurrence.

Starting from __pos, searches backward for __c within this string. If found, returns the index where it was found. If not found, returns npos.

`rfind` (string) — bestie, where was the last time you saw this? 🫶

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind
    (const __versa_string< _CharT, _Traits, _Alloc, _Base > & __str,
    size_type __pos = npos) const [inline],  [noexcept]

Find last position of a string.

Parameters

__str — string to locate.
__pos — index of character to search back from (default end).

Returns

Index of start of last occurrence.

Starting from __pos, searches backward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.

References

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind()

Referenced by

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind()

`rfind` (C substring) — the "last seen with a length" vibe 🎀

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string< _CharT,
    _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string< _CharT,
    _Traits, _Alloc, _Base >::rfind (const _CharT * __s, size_type __pos,
    size_type __n) const

Find last position of a C substring.

Parameters

__s — C string to locate.
__pos — index of character to search back from.
__n — number of characters from s to search for.

Returns

Index of start of last occurrence.

Starting from __pos, searches backward for the first __n characters in __s within this string. If found, returns the index where it begins. If not found, returns npos.

References

std::min()

`rfind` (C string) — no length, just vibes ✨

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind
    (const _CharT * __s, size_type __pos = npos) const [inline]

Find last position of a C string.

Parameters

__s — C string to locate.
__pos — index of character to start search at (default end).

Returns

Index of start of last occurrence.

Starting from __pos, searches backward for the value of __s within this string. If found, returns the index where it begins. If not found, returns npos.

References

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::rfind()

`shrink_to_fit` — the "reduce capacity to size" hint, non-binding bestie 💅

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base
    >::shrink_to_fit () [inline],  [noexcept]

A non-binding request to reduce capacity() to size().

References

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::capacity()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::reserve()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size()

`size` — the character count, no nulls invited 🚫

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> size_type
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::size ()
    const [inline],  [noexcept]

Returns the number of characters in the string, not including any null-termination.

Referenced by

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::at()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::at()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::back()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::cend()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::compare()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::empty()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::end()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::end()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_not_of()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_first_of()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::find_last_of()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::insert()
__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::operator+()
__gnu_cxx::operator==()
__gnu_cxx::operator==()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator[]()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::pop_back()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::push_back()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::replace()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::shrink_to_fit()

`substr` — get a little slice of the string 🍰

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> __versa_string
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::substr
    (size_type __pos = 0, size_type __n = npos) const [inline]

Get a substring.

Parameters

__pos — index of first character (default 0).
__n — number of characters in substring (default remainder).

Returns

The new string.

Exceptions

std::out_of_range if pos > size().

Construct and return a new string using the __n characters starting at __pos. If the string is too short, use the remainder of the characters. If __pos is beyond the end of the string, out_of_range is thrown.

`swap` — trade contents in constant time, no cap 🏃‍♀️

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> void
    __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::swap
    (__versa_string< _CharT, _Traits, _Alloc, _Base > & __s) [inline],
    [noexcept]

Swap contents with another string.

Parameters

__s — string to swap with.

Exchanges the contents of this string with that of __s in constant time.

Referenced by

__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::assign()
__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::operator=()
__gnu_cxx::swap()

💖 Member Data Documentation 💖

`npos` — the value returned when things fail 😭

template<typename _CharT , typename _Traits , typename _Alloc , template<
    typename, typename, typename > class _Base> const __versa_string<
    _CharT, _Traits, _Alloc, _Base >::size_type __gnu_cxx::__versa_string<
    _CharT, _Traits, _Alloc, _Base >::npos [static]

Value returned by various member functions when they fail.

🌸 Author 🌸

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

And that's the whole page, bestie 💅 the footer line is your classic libstd__gnu_cxx::__v..._Alloc, _Base >(3cxx) version/date stamp — shoutout to Doxygen for auto-generating this for libstdc++ from the source code, periodt. 🫶✨

📦 where this page comes from

ubuntu noble: libstdc++-14-doc 14-20240412-0ubuntu1
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-06: a language model's rewrite of the original, under its terms

__GNU_CXX::__VERSA_STRING(3cxx)

🌸 NAME 🌸

✨ SYNOPSIS ✨

🎀 Public Types 🎀

🦋 STATIC PUBLIC ATTRIBUTES 🦋

💜 DETAILED DESCRIPTION 💜

🎀 CONSTRUCTOR & DESTRUCTOR DOCUMENTATION 🎀

the default one 🌸

copy constructor 💖

move constructor 🦋

initializer_list constructor 🍓

substring constructors 🌈

character array constructor 💅

C string constructor ⭐

the "n copies of one character" constructor 🌸

the iterator range constructor ✨

destructor 💀

✨ MEMBER FUNCTION DOCUMENTATION ✨

append — the range one 🦋

append — the whole-string one 👑

append — the substring one 🎀

append — C string era 🎀

append — C substring edition 🦋

append — multiple characters, okay?? 💀

append — initializer_list moment ✨

assign — move assignment but make it cute 💖

assign — range of characters 🌈

assign — copy assignment, the classic 🎀

assign — substring of a string 🍓

assign — C string, but make it safe 🧚

assign — C substring, bestie sized 🦋

assign — multiple characters, we love a repeat 🔥

assign — initializer_list assigns 💖

at — the safe access era 👑

at const — same safety, no editing 🔒

back const — last character, but make it const 🎀

back — last character, now with edits 🦋

begin const — first character, read-only 🌸

begin — first character, full access 👑

🌟 c_str() — the raw-pointer moment

📦 capacity() — how much room before the next glow-up

🥇 cbegin() — read-only, first character

🏁 cend() — read-only, one past the end

🧹 clear() — the reset button

⚖️ compare(const __versa_string& __str) — the O.G. comparison

⚖️ compare(const _CharT * __s) — string vs. C string

⚖️ compare(size_type __pos, size_type __n, const __versa_string& __str) — substring vs. string

⚖️ compare(size_type __pos, size_type __n1, const _CharT * __s) — substring vs. C string

⚖️ compare(size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)

⚖️ compare(size_type __pos1, size_type __n1, const __versa_string& __str, size_type __pos2, size_type __n2) — substring vs. substring, the double-feature

📤 copy(_CharT * __s, size_type __n, size_type __pos = 0) — dump it into a C string

🔄 crbegin() — read-only, last character first

🔄 crend() — read-only, one before the first

🫶 data()

🦋 empty()

🌸 end() — the const one

🎀 end() — the non-const one

💜 erase(const_iterator __first, const_iterator __last)

🧚 erase(const_iterator __position)

⭐ erase(size_type __pos = 0, size_type __n = npos)

🌈 find(_CharT __c, size_type __pos = 0)

🍓 find(const __versa_string& __str, size_type __pos = 0)

🎀 find(const _CharT * __s, size_type __pos, size_type __n)

✨ find(const _CharT * __s, size_type __pos = 0)

💀 find_first_not_of(_CharT __c, size_type __pos = 0)

🧚 find_first_not_of(const __versa_string& __str, size_type __pos = 0)

🔥 find_first_not_of(const _CharT * __s, size_type __pos, size_type __n)

🌸 find_first_not_of(const _CharT * __s, size_type __pos = 0)

💅 find_first_of — bestie, where's the first match?

🌸 find_first_of (_CharT __c, size_type __pos = 0) — const, [inline], [noexcept]

🦋 find_first_of (const __versa_string& __str, size_type __pos = 0) — const, [inline], [noexcept]

🎀 find_first_of (const _CharT* __s, size_type __pos, size_type __n)

🧚 find_first_of (const _CharT* __s, size_type __pos = 0) — const, [inline]

👑 find_last_not_of — the "anything but that" girlie

💜 find_last_not_of (_CharT __c, size_type __pos = npos) — const, [noexcept]

⭐ find_last_not_of (const __versa_string& __str, size_type __pos = npos) — const, [inline], [noexcept]

🌈 find_last_not_of (const _CharT* __s, size_type __pos, size_type __n)

🍓 find_last_not_of (const _CharT* __s, size_type __pos = npos) — const, [inline]

🔥 find_last_of — searching backwards for the moment

🌸 find_last_of (_CharT __c, size_type __pos = npos) — const, [inline], [noexcept]

`append` — the range one 🦋

`append` — the whole-string one 👑

`append` — the substring one 🎀

🌟 `c_str()` — the raw-pointer moment

📦 `capacity()` — how much room before the next glow-up

🥇 `cbegin()` — read-only, first character

🏁 `cend()` — read-only, one past the end

🧹 `clear()` — the reset button

⚖️ `compare(const __versa_string& __str)` — the O.G. comparison

⚖️ `compare(const _CharT * __s)` — string vs. C string

⚖️ `compare(size_type __pos, size_type n, const versa_string& __str)` — substring vs. string

⚖️ `compare(size_type __pos, size_type __n1, const _CharT * __s)` — substring vs. C string

⚖️ `compare(size_type __pos, size_type __n1, const _CharT * __s, size_type __n2)`

⚖️ `compare(size_type __pos1, size_type n1, const versa_string& __str, size_type __pos2, size_type __n2)` — substring vs. substring, the double-feature

📤 `copy(_CharT * __s, size_type __n, size_type __pos = 0)` — dump it into a C string

🔄 `crbegin()` — read-only, last character first

🔄 `crend()` — read-only, one before the first

🫶 `data()`

🦋 `empty()`

🌸 `end()` — the `const` one

🎀 `end()` — the non-`const` one

💜 `erase(const_iterator __first, const_iterator __last)`

🧚 `erase(const_iterator __position)`

⭐ `erase(size_type __pos = 0, size_type __n = npos)`

🌈 `find(_CharT __c, size_type __pos = 0)`

🍓 `find(const __versa_string& __str, size_type __pos = 0)`

🎀 `find(const _CharT * __s, size_type __pos, size_type __n)`

✨ `find(const _CharT * __s, size_type __pos = 0)`

💀 `find_first_not_of(_CharT __c, size_type __pos = 0)`

🧚 `find_first_not_of(const __versa_string& __str, size_type __pos = 0)`

🔥 `find_first_not_of(const _CharT * __s, size_type __pos, size_type __n)`

🌸 `find_first_not_of(const _CharT * __s, size_type __pos = 0)`

💅 `find_first_of` — bestie, where's the first match?

🌸 `find_first_of` (`_CharT __c`, `size_type __pos = 0`) — `const`, `[inline]`, `[noexcept]`

🦋 `find_first_of` (`const __versa_string& __str`, `size_type __pos = 0`) — `const`, `[inline]`, `[noexcept]`

🎀 `find_first_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

🧚 `find_first_of` (`const _CharT* __s`, `size_type __pos = 0`) — `const`, `[inline]`

👑 `find_last_not_of` — the "anything but that" girlie

💜 `find_last_not_of` (`_CharT __c`, `size_type __pos = npos`) — `const`, `[noexcept]`

⭐ `find_last_not_of` (`const __versa_string& __str`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

🌈 `find_last_not_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

🍓 `find_last_not_of` (`const _CharT* __s`, `size_type __pos = npos`) — `const`, `[inline]`

🔥 `find_last_of` — searching backwards for the moment

🌸 `find_last_of` (`_CharT __c`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

🦋 `find_last_of` (`const __versa_string& __str`, `size_type __pos = npos`) — `const`, `[inline]`, `[noexcept]`

🧚 `find_last_of` (`const _CharT* __s`, `size_type __pos`, `size_type __n`)

⭐ `find_last_of` (`const _CharT* __s`, `size_type __pos = npos`) — `const`, `[inline]`

🎀 `front` — the first character, main character energy

💖 `front` — `const`, `[inline]`, `[noexcept]`

🔓 `front`

`get_allocator` 🎀

`insert` — one single character 🌸

`insert` — a whole range of characters 🦋

`insert` — multiple characters, iterator edition 🎀

`insert` — initializer_list edition 🍓

`insert` — a C string goes in 🌈

`insert` — a C substring, with a length this time 🧚

`insert` — n copies of a char at an index 👑

`insert` — jam a whole string in there 💖

`insert` — the full substring situation 🌸

`length` 🧚

`max_size` ⭐

`operator+=` — append a character 🍓

`operator+=` — append a string 🫶

`operator+=` — append a C string 🦋

💅 `operator+=` (the `initializer_list` one)

🚚 `operator=` (move assignment)

🔤 `operator=` (single character)

📋 `operator=` (copy assignment)

🪢 `operator=` (C string)

🎀 `operator=` (`initializer_list`)

🔍 `operator[]` (const version)

🔓 `operator[]` (the read/write one)

✂️ `pop_back`

➕ `push_back`

🔙 `rbegin` (const)

🔄 `rbegin` (read/write)

🏁 `rend` (const)

🎬 `rend` (read/write)

🩹 `replace` — range with range