__GNU_DEBUG::BASIC_STRING(3cxx)
💖 NAME 💖
Okay so this is the __gnu_debug::ba...s, _Allocator >(3cxx) manual page, and the main character is __gnu_debug::basic_string< _CharT, _Traits, _Allocator >. It’s the class std::basic_string with safety/checking/debug instrumentation. No cap, bestie — it’s giving string energy with debug instrumentation in the mix. 🎀
✨ SYNOPSIS ✨
First things first, include the header:
#include <string>It inherits from __gnu_debug::_Safe_container< _SafeContainer, _Alloc, _SafeBase, _IsCxx11AllocatorAware > and std::basic_string< _CharT, _Traits, _Alloc >. Slay. 🦋
🫶 Public Types 🫶
allocator_type—typedef _Allocator allocator_type; that’s the allocator type, periodt. 💅const_iterator—typedef __gnu_debug::_Safe_iterator< typename _Base::const_iterator, basic_string > const_iterator; the checked const iterator vibe. ✨const_pointer—typedef _Base::const_pointer const_pointer; the const pointer type. 🎀const_reference—typedef _Base::const_reference const_reference; the const reference type. 🌸const_reverse_iterator—typedef std::reverse_iterator< const_iterator > const_reverse_iterator; reverse iterator but const, iconic. 🦋difference_type—typedef _Base::difference_type difference_type; the difference type. 💜iterator—typedef __gnu_debug::_Safe_iterator< typename _Base::iterator, basic_string > iterator; the checked iterator, lowkey essential. 🔥pointer—typedef _Base::pointer pointer; the pointer type. ⭐reference—typedef _Base::reference reference; the reference type. 🫶reverse_iterator—typedef std::reverse_iterator< iterator > reverse_iterator; reverse iterator energy, fr fr. 🌈size_type—typedef _Base::size_type size_type; the size type. 🍓traits_type—typedef _Traits traits_type; the traits type. 🧚value_type—typedef _Traits::char_type value_type; the character type, and yes it’s giving main-character energy. 👑
🌸 Public Member Functions 🌸
okay bestie, this is the whole entire menu of what she can do 💖 every overload, every default argument, nothing skipped, nothing merged. grab a lil snack, we're going through all of it.
basic_string (_Base &&__base) noexcept— the_Baservalue-ref constructor, and she'snoexceptabout it ✨template<typename _InputIterator > basic_string (_InputIterator __begin, _InputIterator __end, const _Allocator &__a=_Allocator())— build her from an iterator range, allocator defaults to_Allocator()basic_string (basic_string &&)=default— the move constructor, defaulted, no notes 💅basic_string (basic_string &&__s, const _Allocator &__a) noexcept(std::is_nothrow_constructible< _Base, _Base, const _Allocator & >::value)— move with an allocator, and thenoexceptis that wholeis_nothrow_constructibleexpression, iykykbasic_string (const _Allocator &__a) noexcept— just an allocator, that's it,noexceptbasic_string (const _Base &__base)— the_Baseconst-ref constructorbasic_string (const _CharT *__s, const _Allocator &__a=_Allocator())— from a_CharTpointer, allocator defaultsbasic_string (const _CharT *__s, size_type __n, const _Allocator &__a=_Allocator())— pointer plus a count__n, allocator defaultsbasic_string (const basic_string &)=default— copy constructor, defaulted 🫶basic_string (const basic_string &__s, const _Allocator &__a)— copy, but you're bringing your own allocatorbasic_string (const basic_string &__str, size_type __pos, size_type __n=_Base::npos, const _Allocator &__a=_Allocator())— the substring constructor;__ndefaults to_Base::npos, allocator defaults toobasic_string (size_type __n, _CharT __c, const _Allocator &__a=_Allocator())—__ncopies of character__c, allocator defaultsbasic_string (std::initializer_list< _CharT > __l, const _Allocator &__a=_Allocator())— from aninitializer_list< _CharT >, allocator defaultstemplate<typename _Operation > void __resize_and_overwrite (size_type __n, _Operation __op)— non-standard version ofresize_and_overwritefor C++11 and above, she's a little special like that 😌const _Base & _M_base () const noexcept— const ref to_Base,noexcept_Base & _M_base () noexcept— non-const ref to_Base,noexcepttemplate<typename _InputIterator > basic_string< _CharT, _Traits, _Alloc > & _M_replace_dispatch (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2, __false_type)— the_M_replace_dispatchinternal, taking two iterators, two_InputIterators and a__false_typetemplate<typename _InIterator > _CharT * _S_construct (_InIterator __beg, _InIterator __end, const _Alloc &__a, forward_iterator_tag)—_S_construct, returns_CharT *, takes a range, an allocator and aforward_iterator_tag
template<typename _InputIterator > basic_string & append (_InputIterator __first, _InputIterator __last)— append an iterator rangebasic_string & append (const _CharT *__s)— append a_CharTpointerbasic_string & append (const _CharT *__s, size_type __n)— append__ncharacters from that pointertemplate<typename _Tp > _If_sv< _Tp, basic_string & > append (const _Tp &__svt)— append astring_view✨template<typename _Tp > _If_sv< _Tp, basic_string & > append (const _Tp &__svt, size_type __pos, size_type __n=npos)— append a range of characters from astring_view,__ndefaults tonposbasic_string & append (const basic_string &__str)— append a string to this string 💖basic_string & append (const basic_string &__str)— yes she's listed again with no description, we don't make the rules 💅basic_string & append (const basic_string &__str, size_type __pos, size_type __n)— no description on this one either, just vibesbasic_string & append (const basic_string &__str, size_type __pos, size_type __n=npos)— append a substring,__ndefaults tonposbasic_string & append (initializer_list< _CharT > __l)— append aninitializer_listof characters 🎀basic_string & append (size_type __n, _CharT __c)— append__nof character__c
template<typename _InputIterator > basic_string & assign (_InputIterator __first, _InputIterator __last)— assign from an iterator rangebasic_string & assign (basic_string &&__str) noexcept(allocator_traits< _Alloc >::is_always_equal::value)— set value to contents of another string, move-style,noexceptdepends onallocator_traits< _Alloc >::is_always_equal::valuebasic_string & assign (basic_string &&__x) noexcept(noexcept(std::declval< _Base & >().assign(std::move(__x))))— the other move assign, with that whole nestednoexcept(noexcept(std::declval< _Base & >().assign(std::move(__x))))situationbasic_string & assign (const _CharT *__s)— assign from a_CharTpointerbasic_string & assign (const _CharT *__s, size_type __n)— assign__nchars from a pointertemplate<typename _Tp > _If_sv< _Tp, basic_string & > assign (const _Tp &__svt)— set value from astring_viewtemplate<typename _Tp > _If_sv< _Tp, basic_string & > assign (const _Tp &__svt, size_type __pos, size_type __n=npos)— set value from a range of characters in astring_view,__ndefaults tonposbasic_string & assign (const basic_string &__str)— set value to contents of another stringbasic_string & assign (const basic_string &__str, size_type __pos, size_type __n)— no description, just the overloadbasic_string & assign (const basic_string &__str, size_type __pos, size_type __n=npos)— set value to a substring of a string,__ndefaults tonposbasic_string & assign (const basic_string &__x)— plain copy assign, no description listedbasic_string & assign (size_type __n, _CharT __c)—__ncopies of__cbasic_string & assign (std::initializer_list< _CharT > __l)— assign from aninitializer_list< _CharT >
reference at (size_type __n)— provides access to the data contained in the string 👑const_reference at (size_type __n) const— same deal, const flavor, provides access to the data contained in the stringreference back ()— the back element, non-constconst_reference back () const noexcept— back element, const,noexceptiterator begin ()— iterator to the startconst_iterator begin () const noexcept— const iterator to the start,noexceptconst _CharT * c_str () const noexcept— theconst _CharT *,noexcept, classicsize_type capacity () const noexcept— how much she can hold,noexceptconst_iterator cbegin () const noexcept— const begin,noexceptconst_iterator cend () const noexcept— const end,noexceptvoid clear ()— clears her out
int compare (const _CharT *__s) const noexcept— compare to a C string,noexcept, returnsintconstexpr int compare (const _CharT *__s) const noexcept— theconstexprversion of the C-string comparetemplate<typename _Tp > _If_sv< _Tp, int > compare (const _Tp &__svt) const noexcept(is_same< _Tp, __sv_type >::value)— compare to astring_view,noexceptpowered byis_same< _Tp, __sv_type >::valueint compare (const basic_string &__str) const— compare to a stringint compare (const basic_string &__str) const— compare to a string, part two, the docs really said "again" 💀template<typename _Tp > _If_sv< _Tp, int > compare (size_type __pos, size_type __n, const _Tp &__svt) const noexcept(is_same< _Tp, __sv_type >::value)— compare to astring_view, with__posand__nint compare (size_type __pos, size_type __n, const basic_string &__str) const— compare substring to a stringint compare (size_type __pos, size_type __n, const basic_string &__str) const— same line again, she's an icon, she repeats herself ✨int compare (size_type __pos, size_type __n1, const _CharT *__s) const— compare substring to a C stringint compare (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2) const— compare substring against a character arrayconstexpr int compare (size_type __pos1, size_type __n1, const _CharT *__s) const—constexprsubstring-vs-C-string, note the__pos1/__n1namingconstexpr int compare (size_type __pos1, size_type __n1, const _CharT *__s, size_type __n2) const—constexpr, plus__n2template<typename _Tp > _If_sv< _Tp, int > compare (size_type __pos1, size_type __n1, const _Tp &__svt, size_type __pos2, size_type __n2=npos) const noexcept(is_same< _Tp, __sv_type >::value)— compare to astring_viewwith__pos1,__n1,__pos2, and__n2=nposint compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos) const— compare substring to a substringint compare (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos) const— compare substring to a substring, listed twice, periodt 💅size_type copy (_CharT *__s, size_type __n, size_type __pos=0) const— copy out__nchars into__sstarting at__pos, which defaults to0const_reverse_iterator crbegin () const noexcept— const reverse begin,noexceptconst_reverse_iterator crend () const noexcept— const reverse end,noexceptconst _CharT * data () const noexcept— const pointer to the data,noexcept_CharT * data () noexcept— return non-const pointer to contents 🔥bool empty () const noexcept— is she empty,noexcept, returnsbooliterator end ()— iterator to the endconst_iterator end () const noexcept— const iterator to the end,noexcept
bool ends_with (_CharT __x) const noexcept— does she end with character__xbool ends_with (basic_string_view< _CharT, _Traits > __x) const noexcept— ends with thatbasic_string_view< _CharT, _Traits >bool ends_with (const _CharT *__x) const noexcept— ends with a_CharTpointeriterator erase (__const_iterator __first, __const_iterator __last)— erase from__firstto__last, note the__const_iteratorspellingiterator erase (__const_iterator __position)— erase at__position,__const_iteratoragainiterator erase (iterator __first, iterator __last)— remove a range of charactersiterator erase (iterator __position)— remove one characterbasic_string & erase (size_type __pos=0, size_type __n=_Base::npos)— the index version,__posdefaults to0,__ndefaults to_Base::npos
size_type find (_CharT __c, size_type __pos=0) const noexcept— find position of a character,__posdefaults to0size_type find (const _CharT *__s, size_type __pos, size_type __n) const noexcept— find position of a C substring, needs__posand__nconstexpr size_type find (const _CharT *__s, size_type __pos, size_type __n) const noexcept— theconstexprversion of that same C-substring findsize_type find (const _CharT *__s, size_type __pos=0) const noexcept— find position of a C string,__posdefaults to0constexpr size_type find (const _CharT *__s, size_type __pos=0) const noexcept—constexprC-string find,__pos=0template<typename _Tp > _If_sv< _Tp, size_type > find (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value)— find position of astring_view,noexcept(is_same< _Tp, __sv_type >::value)size_type find (const basic_string &__str, size_type __pos=0) const noexcept— find position of a stringsize_type find (const basic_string &__str, size_type __pos=0) const noexcept— find position of a string, again, because of course 🦋size_type find_first_not_of (_CharT __c, size_type __pos=0) const noexcept— find position of a different charactersize_type find_first_not_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept— find position of a character not in a C substringconstexpr size_type find_first_not_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept—constexprversion of that onesize_type find_first_not_of (const _CharT *__s, size_type __pos=0) const noexcept— find position of a character not in a C string,__pos=0constexpr size_type find_first_not_of (const _CharT *__s, size_type __pos=0) const noexcept— theconstexprtwin,__pos=0template<typename _Tp > _If_sv< _Tp, size_type > find_first_not_of (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value)— find position of a character not in astring_viewsize_type find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept— find position of a character not in stringsize_type find_first_not_of (const basic_string &__str, size_type __pos=0) const noexcept— find position of a character not in string, duplicated, she said copy-paste slay 💖
size_type find_first_of (_CharT __c, size_type __pos=0) const noexcept— find position of a charactersize_type find_first_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept— find position of a character of a C substringconstexpr size_type find_first_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept—constexprflavor of that same onesize_type find_first_of (const _CharT *__s, size_type __pos=0) const noexcept— find position of a character of a C stringconstexpr size_type find_first_of (const _CharT *__s, size_type __pos=0) const noexcept—constexpr, C string,__pos=0template<typename _Tp > _If_sv< _Tp, size_type > find_first_of (const _Tp &__svt, size_type __pos=0) const noexcept(is_same< _Tp, __sv_type >::value)— find position of a character of astring_viewsize_type find_first_of (const basic_string &__str, size_type __pos=0) const noexcept— find position of a character of stringsize_type find_first_of (const basic_string &__str, size_type __pos=0) const noexcept— find position of a character of string, and yes, she's here twice 🌈
size_type find_last_not_of (_CharT __c, size_type __pos=npos) const noexcept— find last position of a different character,__posdefaults tonposthis time, not0size_type find_last_not_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept— find last position of a character not in a C substringconstexpr size_type find_last_not_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept—constexprversion of that last-not-of call 🎀
okay so the overload parade continues 🎠 no skipping, bestie, we're reading every single one of these, hydrate first 💧
constexpr size_type find_last_not_of (const _CharT *__s, size_type __pos=_Base::npos) const noexcept— no blurb in the docs for this one, she's mysterious 💅size_type find_last_not_of (const _CharT *__s, size_type __pos=npos) const noexcept— Find last position of a character not in C string. like, "where's the last char that's not in this C string" energy 🔍template<typename _Tp > _If_sv< _Tp, size_type > find_last_not_of (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value)— same hunt, but the "not in here" thing is a string_view 🌸size_type find_last_not_of (const basic_string &__str, size_type __pos=npos) const noexcept— Find last position of a character not in string.size_type find_last_not_of (const basic_string &__str, size_type __pos=npos) const noexcept— and yeah it's listed twice in the docs, we don't ask questions 💀size_type find_last_of (_CharT __c, size_type __pos=npos) const noexcept— Find last position of a character. last time this char shows up, go 🎯size_type find_last_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept— Find last position of a character of C substring.constexpr size_type find_last_of (const _CharT *__s, size_type __pos, size_type __n) const noexcept— theconstexprtwin, no blurb supplied ✨constexpr size_type find_last_of (const _CharT *__s, size_type __pos=_Base::npos) const noexcept— also no blurb, just vibes 🦋size_type find_last_of (const _CharT *__s, size_type __pos=npos) const noexcept— Find last position of a character of C string.template<typename _Tp > _If_sv< _Tp, size_type > find_last_of (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value)— Find last position of a character of string. but the string is a string_view 🫶size_type find_last_of (const basic_string &__str, size_type __pos=npos) const noexcept— Find last position of a character of string.size_type find_last_of (const basic_string &__str, size_type __pos=npos) const noexcept— yes bestie, twice again, iconic behaviour honestly 👑
reference front ()— the docs give us nothing here 😭const_reference front () const noexcept— const flavour, also un-blurbedallocator_type get_allocator () const noexcept— Return copy of allocator used to construct this string. she remembers who made her 🥹
the insert era, prepare yourself 💅
iterator insert (__const_iterator __p, _CharT __c)— no description given 🌈template<typename _InputIterator > iterator insert (__const_iterator __p, _InputIterator __first, _InputIterator __last)— also no descriptioniterator insert (const_iterator __p, size_type __n, _CharT __c)— nope, none here eitheriterator insert (const_iterator __p, std::initializer_list< _CharT > __l)— still none 🎀iterator insert (iterator __p, _CharT __c)— Insert one character. one (1) lil guy 🐣template<class _InputIterator > void insert (iterator __p, _InputIterator __beg, _InputIterator __end)— Insert a range of characters. whole squad, in they go 🚌void insert (iterator __p, initializer_list< _CharT > __l)— Insert an initializer_list of characters.void insert (iterator __p, size_type __n, _CharT __c)— Insert multiple characters. spam that char, respectfully 🍓basic_string & insert (size_type __pos, const _CharT *__s)— undocumented, she's a mystery 🕵️♀️basic_string & insert (size_type __pos, const _CharT *__s, size_type __n)— also no blurbtemplate<typename _Tp > _If_sv< _Tp, basic_string & > insert (size_type __pos, const _Tp &__svt)— Insert a string_view. ✨basic_string & insert (size_type __pos, size_type __n, _CharT __c)— no blurb, moving on 🏃♀️template<typename _Tp > _If_sv< _Tp, basic_string & > insert (size_type __pos1, const _Tp &__svt, size_type __pos2, size_type __n=npos)— Insert a string_view. again, but with a position inside the view too 🪄basic_string & insert (size_type __pos1, const basic_string &__str)— Insert value of a string.basic_string & insert (size_type __pos1, const basic_string &__str)— listed twice, we move 💀basic_string & insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n)— no blurb 🌸basic_string & insert (size_type __pos1, const basic_string &__str, size_type __pos2, size_type __n=npos)— Insert a substring. a little slice of her 🍰
size_type length () const noexcept— Returns the number of characters in the string, not including any null-termination. the real count, no sneaky terminator 👀size_type max_size () const noexcept— Returns thesize()of the largest possible string. her absolute limit, respectfully 🔥
operator __sv_type () const noexcept— Convert to a string_view. glow-up into a view 🦋
operator city, we're literally living here now 🏙️
basic_string & operator+= (_CharT __c)— no blurb 🎀basic_string & operator+= (const _CharT *__s)— none here eithertemplate<typename _Tp > _If_sv< _Tp, basic_string & > operator+= (const _Tp &__svt)— Append a string_view. 💖basic_string & operator+= (const basic_string &__str)— Append a string to this string. girl math: string + string = longer string ✨basic_string & operator+= (const basic_string &__str)— twice, slay 💅basic_string & operator+= (std::initializer_list< _CharT > __l)— no description 🌈basic_string & operator= (_CharT __c)— undocumentedbasic_string & operator= (basic_string &&)=default— also undocumented, note the=default🫶basic_string & operator= (const _CharT *__s)— still nothingbasic_string & operator= (const basic_string &)=default—=defaultagain, that's all we know 😌basic_string & operator= (std::initializer_list< _CharT > __l)— no blurb, bye 👋reference operator[] (size_type __pos)— no description given 🎯const_reference operator[] (size_type __pos) const noexcept— const one, also no description
void pop_back ()— undocumented 💀void push_back (_CharT __c)— also undocumented, cute little pair tho 🫶reverse_iterator rbegin ()— no blurb 🌀const_reverse_iterator rbegin () const noexcept— nonereverse_iterator rend ()— noneconst_reverse_iterator rend () const noexcept— none, ok moving 🏃♀️
the replace cinematic universe (this is the big one, stay with me) 🌌
template<typename _InputIterator > basic_string & replace (__const_iterator __i1, __const_iterator __i2, _InputIterator __j1, _InputIterator __j2)— undocumented 🎀basic_string & replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s)— nonebasic_string & replace (__const_iterator __i1, __const_iterator __i2, const _CharT *__s, size_type __n)— nonebasic_string & replace (__const_iterator __i1, __const_iterator __i2, const basic_string &__str)— nonebasic_string & replace (__const_iterator __i1, __const_iterator __i2, size_type __n, _CharT __c)— nonebasic_string & replace (__const_iterator __i1, __const_iterator __i2, std::initializer_list< _CharT > __l)— none 🌸template<typename _Tp > _If_sv< _Tp, basic_string & > replace (const_iterator __i1, const_iterator __i2, const _Tp &__svt)— Replace range of characters with string_view. ✨basic_string & replace (iterator __i1, iterator __i2, _CharT *__k1, _CharT *__k2)— no blurb, note these are non-const pointers 👀template<class _InputIterator > basic_string & replace (iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2)— Replace range of characters with range. trade a range for a range, fair trade 🤝basic_string & replace (iterator __i1, iterator __i2, const _CharT *__k1, const _CharT *__k2)— undocumentedbasic_string & replace (iterator __i1, iterator __i2, const _CharT *__s)— Replace range of characters with C string.basic_string & replace (iterator __i1, iterator __i2, const _CharT *__s, size_type __n)— Replace range of characters with C substring.basic_string & replace (iterator __i1, iterator __i2, const basic_string &__str)— Replace range of characters with string.basic_string & replace (iterator __i1, iterator __i2, const_iterator __k1, const_iterator __k2)— no descriptionbasic_string & replace (iterator __i1, iterator __i2, initializer_list< _CharT > __l)— Replace range of characters with initializer_list.basic_string & replace (iterator __i1, iterator __i2, iterator __k1, iterator __k2)— no blurb 🌀basic_string & replace (iterator __i1, iterator __i2, size_type __n, _CharT __c)— Replace range of characters with multiple characters. 🍓template<typename _Tp > _If_sv< _Tp, basic_string & > replace (size_type __pos, size_type __n, const _Tp &__svt)— Replace range of characters with string_view. ✨basic_string & replace (size_type __pos, size_type __n, const basic_string &__str)— Replace characters with value from another string. borrowing her fit 💖basic_string & replace (size_type __pos, size_type __n1, const _CharT *__s)— undocumentedbasic_string & replace (size_type __pos, size_type __n1, const _CharT *__s, size_type __n2)— undocumentedbasic_string & replace (size_type __pos, size_type __n1, size_type __n2, _CharT __c)— undocumented 🌈template<typename _Tp > _If_sv< _Tp, basic_string & > replace (size_type __pos1, size_type __n1, const _Tp &__svt, size_type __pos2, size_type __n2=npos)— Replace range of characters with string_view. the deluxe version 🎀basic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str)— no blurbbasic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2)— no blurbbasic_string & replace (size_type __pos1, size_type __n1, const basic_string &__str, size_type __pos2, size_type __n2=npos)— Replace characters with value from another string. 😌
void reserve ()— Equivalent toshrink_to_fit(). yes, the zero-arg one does that, read it twice bestie 👀void reserve (size_type __res_arg)— Attempt to preallocate enough memory for specified number of characters. grabbing seats before the squad arrives 🪑void resize (size_type __n)— no description given 🎀void resize (size_type __n, _CharT __c)— also nonesize_type rfind (_CharT __c, size_type __pos=npos) const noexcept— Find last position of a character. reverse search, go backwards babe 🌀constexpr size_type rfind (const _CharT *__s, size_type __pos, size_type __n) const— undocumented ✨size_type rfind (const _CharT *__s, size_type __pos, size_type __n) const noexcept— Find last position of a C substring.constexpr size_type rfind (const _CharT *__s, size_type __pos=_Base::npos) const— undocumentedsize_type rfind (const _CharT *__s, size_type __pos=npos) const noexcept— Find last position of a C string.template<typename _Tp > _If_sv< _Tp, size_type > rfind (const _Tp &__svt, size_type __pos=npos) const noexcept(is_same< _Tp, __sv_type >::value)— Find last position of a string_view. 💅size_type rfind (const basic_string &__str, size_type __pos=npos) const noexcept— Find last position of a string.size_type rfind (const basic_string &__str, size_type __pos=npos) const noexcept— twice, of course 💀void shrink_to_fit () noexcept— no blurb 🌸size_type size () const noexcept— Returns the number of characters in the string, not including any null-termination. same deal aslength(), no terminator counted ⭐bool starts_with (_CharT __x) const noexcept— undocumentedbool starts_with (basic_string_view< _CharT, _Traits > __x) const noexcept— undocumentedbool starts_with (const _CharT *__x) const noexcept— undocumented, three lil starters with no notes 🙈basic_string substr (size_type __pos=0, size_type __n=_Base::npos) const— no description given 🎀void swap (basic_string &__s) noexcept(/*conditional */)— Swap contents with another string. trade fits, note thenoexcept(/*conditional */)👀void swap (basic_string &__x) noexcept(/*conditional */)— no blurb, samenoexcept(/*conditional */)energy 🔁
🎀 Static Public Attributes 🎀
static const size_type npos— Value returned by various member functions when they fail. the "nope, didn't find it" number 💔
🛡️ Protected Member Functions 🛡️
constexpr void _M_swap (_Safe_container &__x) noexcept— no blurb in the docs, she's internal business 🤫
🫶 Friends 🫶
template<typename _ItT , typename _SeqT , typename _CatT > class ::__gnu_debug::_Safe_iterator— bestie privileges granted, no description given 🎟️
💖 Detailed Description 💖
template<typename _CharT, typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
class __gnu_debug::basic_string< _CharT, _Traits, _Allocator >"Class std::basic_string with safety/checking/debug instrumentation."
that's the whole pitch fr fr — it's std::basic_string but with safety/checking/debug instrumentation bolted on, and she's telling you that up front 💅✨
👑 Member Function Documentation 👑
okay bestie, this is the big one — every member function, alphabetically, no skips. grab a snack 🍓
💫 __resize_and_overwrite
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Operation >
void std::basic_string< _CharT, _Traits, _Alloc >::__resize_and_overwrite
(size_type __n, _Operation __op) [inherited]Non-standard version of resize_and_overwrite for C++11 and above. yes it's got the double underscore, it's a vibe, don't @ me 💅
🔥 append — the string_view edition
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::append
(const _Tp & __svt) [inline], [inherited]Append a string_view.
- Parameters
__svt— the object convertible to string_view that's getting appended 🫶
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
🌸 append — string_view but make it a slice
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::append
(const _Tp & __svt, size_type __pos, size_type __n = npos) [inline], [inherited]Append a range of characters from a string_view. little slice of string_view, iconic ✨
- Parameters
__svt— the object convertible to string_view to be appended from.__pos— the position in the string_view to append from.__n— the number of characters to append from the string_view.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
💖 append — the classic string-on-string situation
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string< _CharT, _Traits, _Alloc > &
std::basic_string< _CharT, _Traits, _Alloc >::append
(const basic_string< _CharT, _Traits, _Alloc > & __str) [inherited]Append a string to this string. the original, the blueprint 👑
- Parameters
__str— the string to append.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::size(), and std::size().
Referenced by all of these besties:
std::basic_string< _CharT, _Traits, _Alloc >::append()std::basic_string< _CharT, _Traits, _Alloc >::append()std::basic_string< _CharT, _Traits, _Alloc >::append()std::basic_string< _CharT, _Traits, _Alloc >::append()std::collate< _CharT >::do_transform()std::basic_string< _CharT, _Traits, _Alloc >::operator+=()std::basic_string< _CharT, _Traits, _Alloc >::operator+=()std::basic_string< _CharT, _Traits, _Alloc >::operator+=()std::basic_string< _CharT, _Traits, _Alloc >::operator+=()std::operator>>()
(yes, four append()s and four operator+=()s — that's genuinely what it says, no cap 😭)
🦋 append — substring core
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string< _CharT, _Traits, _Alloc > &
std::basic_string< _CharT, _Traits, _Alloc >::append
(const basic_string< _CharT, _Traits, _Alloc > & __str,
size_type __pos, size_type __n = npos) [inherited]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.
- Exceptions —
std::out_of_rangeif__posis not a valid index. 🚨
This function appends __n characters from __str starting at __pos to this string. If __n is is larger than the number of available characters in __str, the remainder of __str is appended. (the double "is is" is in the source, we respect the source in this house 🫡)
References std::size().
🎀 append — initializer_list era
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::append
(initializer_list< _CharT > __l) [inline], [inherited]Append an initializer_list of characters.
- Parameters
__l— the initializer_list of characters to append.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
🌈 assign — move it, move it
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::assign
(basic_string< _CharT, _Traits, _Alloc > && __str) [inline], [noexcept], [inherited]Set value to contents of another string.
- 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. ⚠️ like, it exists, but don't go assuming things about it, bestie.
References std::basic_string< _CharT, _Traits, _Alloc >::swap().
🧚 assign — from a string_view
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::assign
(const _Tp & __svt) [inline], [inherited]Set value from a string_view.
- Parameters
__svt— the source object convertible to string_view.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
💜 assign — string_view, sliced
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::assign
(const _Tp & __svt, size_type __pos, size_type __n = npos) [inline], [inherited]Set value from a range of characters in a string_view.
- Parameters
__svt— the source object convertible to string_view.__pos— the position in the string_view to assign from.__n— the number of characters to assign.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
🫶 assign — copy the whole thing
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string< _CharT, _Traits, _Alloc > &
std::basic_string< _CharT, _Traits, _Alloc >::assign
(const basic_string< _CharT, _Traits, _Alloc > & __str) [inherited]Set value to contents of another string.
- Parameters
__str— source string to use.
- Returns — Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::get_allocator().
Referenced by this whole friend group:
std::basic_string< _CharT, _Traits, _Alloc >::assign()std::basic_string< _CharT, _Traits, _Alloc >::assign()std::basic_string< _CharT, _Traits, _Alloc >::assign()std::basic_string< _CharT, _Traits, _Alloc >::assign()std::basic_string< _CharT, _Traits, _Alloc >::assign()std::basic_string< _CharT, _Traits, _Alloc >::operator=()std::basic_string< _CharT, _Traits, _Alloc >::operator=()std::basic_string< _CharT, _Traits, _Alloc >::operator=()std::basic_string< _CharT, _Traits, _Alloc >::operator=()std::basic_string< _CharT, _Traits, _Alloc >::operator=()std::basic_stringbuf< _CharT, _Traits, _Alloc >::overflow()std::basic_stringbuf< _CharT, _Traits, _Alloc >::str()std::basic_stringbuf< _CharT, _Traits, _Alloc >::str()
five assign()s and five operator=()s, i counted, they're all really there 💀
⭐ assign — substring behavior
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::assign
(const basic_string< _CharT, _Traits, _Alloc > & __str,
size_type __pos, size_type __n = npos) [inline], [inherited]Set value to a substring of a string.
- 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_rangeif 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 is larger than the number of available characters in __str, the remainder of __str is used.
References std::basic_string< _CharT, _Traits, _Alloc >::assign().
🍓 at — the safe one (read/write)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
reference std::basic_string< _CharT, _Traits, _Alloc >::at (size_type __n) [inline]Provides access to the data contained in the string.
- Parameters
__n— the index of the character to access.
- Returns — read/write reference to the character.
- Exceptions —
std::out_of_rangeif 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.
🩵 at — the safe one (read-only)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
const_reference std::basic_string< _CharT, _Traits, _Alloc >::at
(size_type __n) const [inline]Provides access to the data contained in the string.
- Parameters
__n— the index of the character to access.
- Returns — read-only (const) reference to the character.
- Exceptions —
std::out_of_rangeif 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.
🌸 back — last character, writable
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
reference std::basic_string< _CharT, _Traits, _Alloc >::back () [inline]Returns a read/write reference to the data at the last element of the string. the final girl of the string, she gets a reference 💅
🧊 back — last character, but const
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
const_reference std::basic_string< _CharT, _Traits, _Alloc >::back () const
[inline], [noexcept]Returns a read-only (constant) reference to the data at the last element of the string. no touchy, just looky 👀
🎈 capacity — how much room she's got
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
size_type std::basic_string< _CharT, _Traits, _Alloc >::capacity () const
[inline], [noexcept]Returns the total number of characters that the string can hold before needing to allocate more memory. it's giving "i have space for you in my life" energy ✨
🏆 compare — versus a C string
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
int std::basic_string< _CharT, _Traits, _Alloc >::compare
(const _CharT * __s) const [inline], [noexcept]Compare to a C string. the OG, the char*, showing up to the party.
- 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 returns it, otherwise the shorter one is ordered first. short king gets the win, that's just the rules 👑
🦋 compare — versus a string_view
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
template<typename _Tp >
_If_sv< _Tp, int > std::basic_string< _CharT, _Traits, _Alloc >::compare
(const _Tp & __svt) const [inline], [noexcept]Compare to a string_view.
- Parameters
__svt— an object convertible to string_view to compare against.
- Returns — Integer
< 0,0, or> 0. - Return value — oh and it returns an integer:
< 0,0, or> 0. ✨
Okay bestie, real talk: it returns an integer< 0if this string is ordered before__str,0if their values are equivalent, or> 0if this string is ordered after__str. It figures out the effective lengthrlenof the strings to compare as the smallest ofsize()andstr.size(). Then it compares the two strings by callingtraits::compare(data(), str.data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first. 💅
References: std::basic_string< _CharT, _Traits, _Alloc >::data(), std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> int std::basic_string<
_CharT, _Traits, _Alloc >::compare (const basic_string< _CharT, _Traits,
_Allocator > & __str) const [inline]🦋 Compare to a string (the version with the pretty defaults)
Literally the same energy as the one above, just with the default template args spelled out all cute. 🌸
__str— the string you're comparing against, bestie.
Returns: an integer < 0, 0, or > 0.
Same deal fr fr: returns an integer< 0if this string is ordered before__str,0if their values are equivalent, or> 0if this string is ordered after__str. It determines the effective lengthrlenof the strings to compare as the smallest ofsize()andstr.size(). Then it compares the two strings by callingtraits::compare(data(), str.data(),rlen). If the result of the comparison is nonzero it returns it; otherwise the shorter one is ordered first. No cap. 🫶
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, int > std::basic_string< _CharT, _Traits, _Alloc >::compare
(size_type __pos, size_type __n, const _Tp & __svt) const [inline],
[noexcept]⭐ Compare to a string_view
Okay so this one's fab because it's [noexcept] — it's giving trustworthy main character energy. 👑
__pos— a position in the string to start comparing from.__n— the number of characters to compare.__svt— an object convertible tostring_viewto compare against.
Returns: an integer < 0, 0, or > 0. 💖
template<typename _CharT , typename _Traits , typename _Alloc > int
std::basic_string< _CharT, _Traits, _Alloc >::compare (size_type __pos,
size_type __n, const basic_string< _CharT, _Traits, _Alloc > & __str)
const [inline], [inherited]🌈 Compare substring to a string
Substring era!! We're not comparing the whole thing anymore, just a lil slice. 🍓
__pos— index of first character of substring.__n— number of characters in substring.__str— string to compare against.
Returns: an integer < 0, 0, or > 0.
So what happens: form the substring of this string from the__ncharacters starting at__pos. Returns an integer< 0if the substring is ordered before__str,0if their values are equivalent, or> 0if the substring is ordered after__str. It determines the effective lengthrlenof the strings to compare as the smallest of the length of the substring and__str.size(). Then it compares the two strings by callingtraits::compare(substring.data(),str.data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first. 😭 (in a slay way)
References: std::basic_string< _CharT, _Traits, _Alloc >::data(), std::min(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> int std::basic_string<
_CharT, _Traits, _Alloc >::compare (size_type __pos, size_type __n,
const basic_string< _CharT, _Traits, _Allocator > & __str) const
[inline]🎀 Compare substring to a string (again, but make it default-args)
Same function, same facts, just the _Traits / _Allocator defaults showing off. Obsessed. ✨
__pos— index of first character of substring.__n— number of characters in substring.__str— string to compare against.
Returns: an integer < 0, 0, or > 0.
Form the substring of this string from the__ncharacters starting at__pos. Returns an integer< 0if the substring is ordered before__str,0if their values are equivalent, or> 0if the substring is ordered after__str. It determines the effective lengthrlenof the strings to compare as the smallest of the length of the substring and__str.size(). Then it compares the two strings by callingtraits::compare(substring.data(),str.data(),rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first. 💜
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> int std::basic_string<
_CharT, _Traits, _Alloc >::compare (size_type __pos, size_type __n1,
const _CharT * __s) const [inline]🧚 Compare substring to a C string
A C string walked in, bestie. No std::basic_string wrapper, just vibes and a pointer. 💀
__pos— index of first character of substring.__n1— number of characters in substring.__s— C string to compare against.
Returns: an integer < 0, 0, or > 0.
Form the substring of this string from the__n1characters starting atpos. Returns an integer< 0if the substring is ordered before__s,0if their values are equivalent, or> 0if the substring is ordered after__s. It determines the effective lengthrlenof the strings to compare as the smallest of the length of the substring and the length of a string constructed from__s. Then it compares the two string by callingtraits::compare(substring.data(),__s,rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first. 🌸
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> int std::basic_string<
_CharT, _Traits, _Alloc >::compare (size_type __pos, size_type __n1,
const _CharT * __s, size_type __n2) const [inline]🔥 Compare substring against a character array
Now there's a __n2 in the mix and it's giving precise. Iconic behaviour. 👑
__pos— index of first character of substring.__n1— number of characters in substring.__s— character array to compare against.__n2— number of characters ofs.
Returns: an integer < 0, 0, or > 0.
Form the substring of this string from the__n1characters starting at__pos. Form a string from the first__n2characters of__s. Returns an integer< 0if this substring is ordered before the string from__s,0if their values are equivalent, or> 0if this substring is ordered after the string from__s. It determines the effective lengthrlenof the strings to compare as the smallest of the length of the substring and__n2. Then it compares the two strings by callingtraits::compare(substring.data(),s,rlen). If the result of the comparison is nonzero it returns it, otherwise the shorter one is ordered first. 🦋
NB:smust have at leastn2characters,'\0'has no special meaning. 🚨 Like, for real for real, do not come in here with a short buffer and expect the null terminator to save you. It will not. It is not that girl. 🙈
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, int > std::basic_string< _CharT, _Traits, _Alloc >::compare
(size_type __pos1, size_type __n1, const _Tp & __svt, size_type __pos2,
size_type __n2 = npos) const [inline], [noexcept]💖 Compare to a string_view (the deluxe two-position edition)
Two positions, two lengths, one very [noexcept] queen. ⭐
__pos1— a position in the string to start comparing from.__n1— the number of characters to compare.__svt— an object convertible tostring_viewto compare against.__pos2— a position in thestring_viewto start comparing from.__n2— the number of characters to compare. It has a default:npos. 🎀
Returns: an integer < 0, 0, or > 0.
template<typename _CharT , typename _Traits , typename _Alloc > int
std::basic_string< _CharT, _Traits, _Alloc >::compare (size_type __pos1,
size_type __n1, const basic_string< _CharT, _Traits, _Alloc > & __str,
size_type __pos2, size_type __n2 = npos) const [inline], [inherited]👑 Compare substring to a substring
Substring vs substring. A whole collision of slices. This is the main event, bestie. 🔥
__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 ofstr.__n2— number of characters in substring ofstr. Defaults tonpos. 💜
Returns: an integer < 0, 0, or > 0.
Form the substring of this string from the__n1characters starting at__pos1. Form the substring of__strfrom the__n2characters starting at__pos2. Returns an integer< 0if this substring is ordered before the substring of__str,0if their values are equivalent, or> 0if this substring is ordered after the substring of__str. It determines the effective lengthrlenof the strings to compare as the smallest of the lengths of the substrings. Then it compares the two strings by callingtraits::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: std::basic_string< _CharT, _Traits, _Alloc >::data(), and std::min().
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> int std::basic_string<
_CharT, _Traits, _Alloc >::compare (size_type __pos1, size_type __n1,
const basic_string< _CharT, _Traits, _Allocator > & __str, size_type
__pos2, size_type __n2 = npos) const [inline]🌟 Compare substring to a substring (default-args remix)
Yeah okay this is the same thing again with the defaults written out. Slay, consistent queen. 💅
__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 ofstr.__n2— number of characters in substring ofstr. Defaults tonpos.
Returns: an integer < 0, 0, or > 0.
Form the substring of this string from the__n1characters starting at__pos1. Form the substring of__strfrom the__n2characters starting at__pos2. Returns an integer< 0if this substring is ordered before the substring of__str,0if their values are equivalent, or> 0if this substring is ordered after the substring of__str. It determines the effective lengthrlenof the strings to compare as the smallest of the lengths of the substrings. Then it compares the two strings by callingtraits::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. 🧚
template<typename _CharT , typename _Traits , typename _Alloc > _CharT *
std::basic_string< _CharT, _Traits, _Alloc >::data () [inline],
[noexcept], [inherited]🫶 data() — return non-const pointer to contents
This is a pointer to the character sequence held by the string. And here's the plot twist: modifying the characters in the sequence is allowed. 😳🔥 It's [noexcept] too, so she's chill about it.
Lowkey read that again — modifying the characters is allowed here. That's the whole point of this overload. You get a_CharT *, not aconst _CharT *, so go off. But bestie, that also means if you write past the end it's on you — this page isn't handing out safety nets. 💀
💖 empty() — the instant “am I giving nothing?” check
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> bool std::basic_string<
_CharT, _Traits, _Alloc >::empty () const [inline], [noexcept]Returns true if the string is empty. Equivalent to *this == ''. That’s it, bestie — the tiniest vibe check in the whole string class. 🎀
✂️ erase(iterator, iterator) — delete a whole little range
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string< _CharT, _Traits, _Alloc >::iterator std::basic_string<
_CharT, _Traits, _Alloc >::erase (iterator __first, iterator __last)
[inherited]Remove a range of characters. Very “clear the group chat from message 12 to 47” energy.
- 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 after removal.
Removes the characters in the range [first,last) from this string. The value of the string doesn’t change if an error is thrown. No cap, that safety bit matters. 🫶
🪄 erase(iterator) — one character, gone
template<typename _CharT , typename _Traits , typename _Alloc > iterator
std::basic_string< _CharT, _Traits, _Alloc >::erase (iterator
__position) [inline], [inherited]Remove one character. Single-target elimination, main character style.
- Parameters
__position— iterator referencing the character to remove.
- Returns — iterator referencing the same location after removal.
Removes the character at __position from this string. The value of the string doesn’t change if an error is thrown. Periodt. 💅
🔎 find(_CharT, size_type) — where’s my character at?
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find (_CharT __c, size_type __pos = 0) const [noexcept]Find position of a character. The classic “have you seen her?” search.
- Parameters
__c— character to locate.__pos— index of character to search from (default0).
- Returns — index of first occurrence.
Starting from __pos, searches forward for __c within this string. If found, returns the index where it was found. If not found, returns npos. Soft launch: npos means she’s not here. 😭
🧵 find(const _CharT*, size_type, size_type) — C substring hunt
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find (const _CharT * __s, size_type __pos, size_type __n) const
[noexcept]Find position of a C substring. You’re not searching the whole C string, just the first __n characters of it. Selective.
- Parameters
__s— C string to locate.__pos— index of character to search from.__n— number of characters fromsto search for.
- Returns — index of start of 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. ✨
🎀 find(const _CharT*, size_type) — C string hunt
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find (const _CharT * __s,
size_type __pos = 0) const [inline], [noexcept]Find position of a C string. Full C-string search, no __n little shortcut.
- Parameters
__s— C string to locate.__pos— index of character to search from (default0).
- Returns — index of start of 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. Slay. 🦋
🌸 find(const _Tp&, size_type) — string_view find
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::find (const _Tp & __svt, size_type __pos = 0) const [inline],
[noexcept]Find position of a string_view. This one is for the object that’s convertible to string_view. Fancy but lowkey.
- Parameters
__svt— the object convertible tostring_viewto locate.__pos— index of character to search from (default0).
- Returns — index of start of first occurrence.
That’s the whole note here — no extra lore in this entry. 🎀
💜 find(const basic_string&, size_type) — inherited string find
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::find (const basic_string<
_CharT, _Traits, _Alloc > & __str, size_type __pos = 0) const [inline],
[noexcept], [inherited]Find position of a string. The [inherited] tag is right there, bestie.
- Parameters
__str— string to locate.__pos— index of character to search from (default0).
- Returns — index of start of first occurrence.
Starting from __pos, searches forward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos.
- References —
std::basic_string< _CharT, _Traits, _Alloc >::data(),std::basic_string< _CharT, _Traits, _Alloc >::find(), andstd::basic_string< _CharT, _Traits, _Alloc >::size().
🌈 find(const basic_string&, size_type) — the allocator-name twin
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find (const basic_string<
_CharT, _Traits, _Allocator > & __str, size_type __pos = 0) const
[inline], [noexcept]Find position of a string. Same “where is she?” mission, but the parameter is spelled with _Allocator in the signature. Character-for-character twin behavior, no invented extras.
- Parameters
__str— string to locate.__pos— index of character to search from (default0).
- Returns — index of start of first occurrence.
Starting from __pos, searches forward for value of __str within this string. If found, returns the index where it begins. If not found, returns npos. 💖
🙈 find_first_not_of(_CharT, size_type) — find literally anything else
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_first_not_of (_CharT __c, size_type __pos = 0) const [noexcept]Find position of a different character. The anti-__c search. Avoid this character at all costs.
- Parameters
__c— character to avoid.__pos— index of character to search from (default0).
- Returns — index of first occurrence.
Starting from __pos, searches forward for a character other than __c within this string. If found, returns the index where it was found. If not found, returns npos. It’s giving “not like other girls” but in index form. 💀
🍓 find_first_not_of(const _CharT*, size_type, size_type) — avoid these C substring chars
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_first_not_of (const _CharT * __s, size_type __pos, size_type
__n) const [noexcept]Find position of a character not in C substring. You’re avoiding only the first __n characters of __s, not the whole thing. Very specific.
- Parameters
__s— C string containing characters to avoid.__pos— index of character to search from.__n— number of characters from__sto consider.
- Returns — index of 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*, size_type) — avoid this C string
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of (const
_CharT * __s, size_type __pos = 0) const [inline], [noexcept]Find position of a character not in C string. Full __s avoid list, no __n limits.
- Parameters
__s— C string containing characters to avoid.__pos— index of character to search from (default0).
- Returns — index of 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. 🌸
🦋 find_first_not_of(const _Tp&, size_type) — avoid these string_view chars
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::find_first_not_of (const _Tp & __svt, size_type __pos = 0) const
[inline], [noexcept]Find position of a character not in a string_view. Same avoid-list energy, but the object is convertible to string_view.
- Parameters
__svt— an object convertible tostring_viewcontaining characters to avoid.__pos— index of character to search from (default0).
- Returns — index of first occurrence.
No extra prose in this entry — just the parameters and the return. Keep it moving, bestie. 💅
💀 find_first_not_of(const basic_string&, size_type) — inherited avoid-string
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of (const
basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = 0)
const [inline], [noexcept], [inherited]Find position of a character not in string. Avoid the characters that live in __str. So real.
- Parameters
__str— string containing characters to avoid.__pos— index of character to search from (default0).
- Returns — index of 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 —
std::basic_string< _CharT, _Traits, _Alloc >::data(),std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(), andstd::basic_string< _CharT, _Traits, _Alloc >::size(). - Referenced by —
std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(),std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of(), andstd::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of().
That’s three identical find_first_not_of() references in the original, and we’re keeping all three. No erasing the receipts. 🫶
🌟 find_first_not_of(const basic_string&, size_type) — allocator-name twin
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_not_of (const
basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos =
0) const [inline], [noexcept]Find position of a character not in string. Same mission, with _Allocator showing up in the parameter type.
- Parameters
__str— string containing characters to avoid.__pos— index of character to search from (default0).
- Returns — index of 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. 💜
🔥 find_first_of(_CharT, size_type) — first matching character
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_of (_CharT __c,
size_type __pos = 0) const [inline], [noexcept]Find position of a character. It’s literally the “do I have this one?” check.
- Parameters
__c— character to locate.__pos— index of character to search from (default0).
- Returns — index of first occurrence.
Starting from __pos, searches forward for the character __c within this string. If found, returns the index where it was found. If not found, returns npos.
Note: equivalent to find(__c, __pos).
Iconic shortcut behavior, no notes missed. 🎀
⭐ find_first_of(const _CharT*, size_type, size_type) — matching chars from a C substring
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_first_of (const _CharT * __s, size_type __pos, size_type __n)
const [noexcept]Find position of a character of C substring. You’re looking for any character from the first __n characters of __s.
- Parameters
__s— string containing characters to locate.__pos— index of character to search from.__n— number of characters fromsto search for.
- Returns — index of first occurrence.
okay so picking right back up where we left off — __pos is your starting point, and you're scrolling forward through the string looking for any one of the first __n characters of __s just vibing in there. Found one? slay, you get the index of where it was. Not found? npos, bestie. Always npos. 😭
✨ find_first_of (C string version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_of (const
_CharT * __s, size_type __pos = 0) const [inline], [noexcept]Find position of a character of C string. fr fr that's the whole gig 💅
Parameters
__s— String containing characters to locate.__pos— Index of character to search from (default0).
Returns
Index of first occurrence.
Starting from __pos, searches forward for one of the characters of __s within this string. Found it? You get the index where it was found. Didn't find it? npos. That's it, that's the whole story 🦋
✨ find_first_of (string_view version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::find_first_of (const _Tp & __svt, size_type __pos = 0) const
[inline], [noexcept]Find position of a character of a string_view. the string_view girly pop version 🎀
Parameters
__svt— An object convertible tostring_viewcontaining characters to locate.__pos— Index of character to search from (default0).
Returns
Index of first occurrence.
✨ find_first_of (basic_string version, the [inherited] one) ✨
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_of (const
basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = 0)
const [inline], [noexcept], [inherited]Find position of a character of string. yes queen, another one 👑
Parameters
__str— String containing characters to locate.__pos— Index of character to search from (default0).
Returns
Index of first occurrence.
Starting from __pos, searches forward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos. same energy, different parameter 💖
References std::basic_string< _CharT, _Traits, _Alloc >::data(), std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_first_of(). (yes it's listing itself three times, no I will not be explaining, it's giving recursion energy 💀)
✨ find_first_of (basic_string version, _Allocator flavored) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_first_of (const
basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos =
0) const [inline], [noexcept]Find position of a character of string. notice the template param says _Allocator in the argument and _Alloc in the class — that is NOT a typo, do not come for me 🌸
Parameters
__str— String containing characters to locate.__pos— Index of character to search from (default0).
Returns
Index of first occurrence.
Starting from __pos, searches forward for one of the characters of __str within this string. If found, returns the index where it was found. If not found, returns npos. 🫶
✨ find_last_not_of (single character version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_last_not_of (_CharT __c, size_type __pos = npos) const
[noexcept]Find last position of a different character. the "not like the other girls" of string search 💅
Parameters
__c— Character to avoid.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, searches backward for a character other than __c within this string. Found one that isn't __c? You get its index. Found nothing? npos. she's picky, she's selective, she's iconic ✨
✨ find_last_not_of (C substring version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_last_not_of (const _CharT * __s, size_type __pos, size_type __n)
const [noexcept]Find last position of a character not in C substring.
Parameters
__s— C string containing characters to avoid.__pos— Index of character to search back from.__n— Number of characters fromsto consider.
Returns
Index of last occurrence.
Starting from __pos, 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 (C string version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of (const
_CharT * __s, size_type __pos = npos) const [inline], [noexcept]Find last position of a character not in C string.
Parameters
__s— C string containing characters to avoid.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, searches backward for a character not contained in __s within this string. Found it? index. Not found? npos. no cap 💯
✨ find_last_not_of (string_view version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::find_last_not_of (const _Tp & __svt, size_type __pos = npos) const
[inline], [noexcept]Find last position of a character not in a string_view. 🎀
Parameters
__svt— An object convertible tostring_viewcontaining characters to avoid.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
✨ find_last_not_of (basic_string version, the [inherited] one) ✨
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of (const
basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = npos)
const [inline], [noexcept], [inherited]Find last position of a character not in string. 🌈
Parameters
__str— String containing characters to avoid.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, 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 std::basic_string< _CharT, _Traits, _Alloc >::data(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of(). (three times. again. it's a whole thing. 💀)
✨ find_last_not_of (basic_string version, _Allocator flavored) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_not_of (const
basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos =
npos) const [inline], [noexcept]Find last position of a character not in string. 🌸
Parameters
__str— String containing characters to avoid.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, 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. 🫶
✨ find_last_of (single character version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_of (_CharT __c,
size_type __pos = npos) const [inline], [noexcept]Find last position of a character. the "yes actually I am looking for you" counterpart to the last one 😌
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. ✨
Note: equivalent to rfind(__c, __pos).
✨ find_last_of (C substring version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::find_last_of (const _CharT * __s, size_type __pos, size_type __n)
const [noexcept]Find last position of a character of C substring. 🔥
Parameters
__s— C string containing characters to locate.__pos— Index of character to search back from.__n— Number of characters fromsto search for.
Returns
Index of last occurrence.
Starting from __pos, 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 (C string version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_of (const _CharT
* __s, size_type __pos = npos) const [inline], [noexcept]Find last position of a character of C string. 👑
Parameters
__s— C string containing characters to locate.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, 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. literally the same deal as always, just backwards 💖
✨ find_last_of (string_view version) ✨
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::find_last_of (const _Tp & __svt, size_type __pos = npos) const
[inline], [noexcept]Find last position of a character of string. 🎀
Parameters
__svt— An object convertible tostring_viewcontaining characters to locate.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
✨ find_last_of (basic_string version, the [inherited] one) ✨
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_of (const
basic_string< _CharT, _Traits, _Alloc > & __str, size_type __pos = npos)
const [inline], [noexcept], [inherited]Find last position of a character of string. 🌈
Parameters
__str— String containing characters to locate.__pos— Index of character to search back from (default end).
Returns
Index of last occurrence.
Starting from __pos, it goes backward looking for any one of the characters in __str that also lives in this string. Found it? You get the index where it's chillin'. Not found? npos. That's it, that's the vibe. 💅
References std::basic_string< _CharT, _Traits, _Alloc >::data(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), and std::basic_string< _CharT, _Traits, _Alloc >::find_last_of().
🌸 find_last_of (the string version, bestie)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::find_last_of (const
basic_string< _CharT, _Traits, _Allocator > & __str, size_type __pos =
npos) const [inline], [noexcept]Find last position of a character of string. Like, the last one, periodt.
Parameters
__str— String containing characters to locate. 👀__pos— Index of character to search back from (default end).
Returns
Index of last occurrence. 🎯
Starting from __pos, 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. No cap.
🦋 front (the glow-up version, read/write)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> reference
std::basic_string< _CharT, _Traits, _Alloc >::front () [inline]Returns a read/write reference to the data at the first element of the string. You can literally touch it. Main character energy at index zero. ✨
🎀 front (const version, look don't touch)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> const_reference
std::basic_string< _CharT, _Traits, _Alloc >::front () const [inline],
[noexcept]Returns a read-only (constant) reference to the data at the first element of the string. Admire from a distance, bestie. 🙈
💜 get_allocator
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> allocator_type
std::basic_string< _CharT, _Traits, _Alloc >::get_allocator () const
[inline], [noexcept]Return copy of allocator used to construct this string. It's giving "here's the receipts of who built me." 🧾
🔥 insert — single character
template<typename _CharT , typename _Traits , typename _Alloc > iterator
std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p,
_CharT __c) [inline], [inherited]Insert one character. Just the one. A little guy. 🍓
Parameters
__p— Iterator referencing position in string to insert at.__c— The character to insert.
Returns
Iterator referencing newly inserted char.
Exceptions
std::length_error— If new length exceedsmax_size().
Inserts character __c at position referenced by __p. If adding character causes the length to exceed max_size(), length_error is thrown. If __p is beyond end of string, out_of_range is thrown. The value of the string doesn't change if an error is thrown. Iconic safety behaviour honestly. 👑
🌈 insert — a whole range, we love a range
template<typename _CharT , typename _Traits , typename _Alloc >
template<class _InputIterator > void std::basic_string< _CharT, _Traits,
_Alloc >::insert (iterator __p, _InputIterator __beg, _InputIterator
__end) [inline], [inherited]Insert a range of characters. Bring the whole friend group. 💖
Parameters
__p— Iterator referencing location in string to insert at.__beg— Start of range.__end— End of range.
Exceptions
std::length_error— If new length exceedsmax_size().
Inserts characters in range [__beg,__end). If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
🧚 insert — initializer_list edition
template<typename _CharT , typename _Traits , typename _Alloc > void
std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p,
initializer_list< _CharT > __l) [inline], [inherited]Insert an initializer_list of characters.
Parameters
__p— Iterator referencing location in string to insert at.__l— Theinitializer_listof characters to insert.
Exceptions
std::length_error— If new length exceedsmax_size().
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
⭐ insert — __n copies of one char
template<typename _CharT , typename _Traits , typename _Alloc > void
std::basic_string< _CharT, _Traits, _Alloc >::insert (iterator __p,
size_type __n, _CharT __c) [inline], [inherited]Insert multiple characters. Copy-paste energy but, like, on purpose. 🫶
Parameters
__p— Iterator referencing location in string to insert at.__n— Number of characters to insert__c— The character to insert.
Exceptions
std::length_error— If new length exceedsmax_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. The value of the string doesn't change if an error is thrown.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), std::basic_string< _CharT, _Traits, _Alloc >::insert(), and std::basic_string< _CharT, _Traits, _Alloc >::insert(). (Yes, five of them. It's a whole family reunion. 😭)
🎀 insert — string_view, the pos version
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp > _If_sv< _Tp, basic_string & > std::basic_string<
_CharT, _Traits, _Alloc >::insert (size_type __pos, const _Tp & __svt)
[inline], [inherited]Insert a string_view. Views are lowkey superior, ngl.
Parameters
__pos— Position in string to insert at.__svt— The object convertible tostring_viewto insert.
Returns
Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
🌸 insert — string_view, the pos + pos + n version
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp > _If_sv< _Tp, basic_string & > std::basic_string<
_CharT, _Traits, _Alloc >::insert (size_type __pos1, const _Tp & __svt,
size_type __pos2, size_type __n = npos) [inline], [inherited]Insert a string_view. But like, a slice of one. Fancy.
Parameters
__pos1— Position in string to insert at.__svt— The object convertible tostring_viewto insert from.__pos2— Position instring_viewto insert from.__n— The number of characters to insert.
Returns
Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::replace().
💅 insert — whole string, no thoughts
template<typename _CharT , typename _Traits , typename _Alloc > basic_string
& std::basic_string< _CharT, _Traits, _Alloc >::insert (size_type
__pos1, const basic_string< _CharT, _Traits, _Alloc > & __str) [inline],
[inherited]Insert value of a string.
Parameters
__pos1— Position in string to insert at.__str— The string to insert.
Returns
Reference to this string.
Exceptions
std::length_error— If new length exceedsmax_size().
Inserts value of __str starting at __pos1. If adding characters causes the length to exceed max_size(), length_error is thrown. The value of the string doesn't change if an error is thrown.
References std::basic_string< _CharT, _Traits, _Alloc >::insert(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
🦋 insert — substring, we're being selective
template<typename _CharT , typename _Traits , typename _Alloc > basic_string
& std::basic_string< _CharT, _Traits, _Alloc >::insert (size_type
__pos1, const basic_string< _CharT, _Traits, _Alloc > & __str, size_type
__pos2, size_type __n = npos) [inline], [inherited]Insert a substring. Only part of the group chat gets invited.
Parameters
__pos1— Position in string to insert at.__str— The string to insert.__pos2— Start of characters instrto insert.__n— Number of characters to insert.
Returns
Reference to this string.
Exceptions
std::length_error— If new length exceedsmax_size().std::out_of_range— Ifpos1 > 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. The value of the string doesn't change if an error is thrown. Bestie, it's safe — mess it up and your string is untouched. 💀
References std::basic_string< _CharT, _Traits, _Alloc >::insert().
🎀 length
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::length () const [inline],
[noexcept]Returns the number of characters in the string, not including any null-termination. So the little \0 gremlin at the end doesn't count, okay? 🙅♀️
💜 max_size
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::max_size () const [inline],
[noexcept]Returns the size() of the largest possible string. The absolute limit. The final boss. 👑
🌈 operator __sv_type — the string_view conversion
template<typename _CharT , typename _Traits , typename _Alloc >
std::basic_string< _CharT, _Traits, _Alloc >::operator __sv_type ()
const [inline], [noexcept], [inherited]Convert to a string_view. Glow-down into a lighter, cuter form. 🦋
Returns
A string_view.
References std::basic_string< _CharT, _Traits, _Alloc >::data(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
🍓 operator+= — appending a string_view
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp > _If_sv< _Tp, basic_string & > std::basic_string<
_CharT, _Traits, _Alloc >::operator+= (const _Tp & __svt) [inline],
[inherited]Append a string_view. Add it to the end, no big deal.
Parameters
__svt— The object convertible tostring_viewto be appended.
Returns
Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
💖 operator+= — appending a whole string
template<typename _CharT , typename _Traits , typename _Alloc > basic_string
& std::basic_string< _CharT, _Traits, _Alloc >::operator+= (const
basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]Append a string to this string. Two strings become one. Soulmate behaviour, fr fr. 🫶
Parameters
__str— The string to append.
Returns
Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::append().
🧚 replace — iterator pair + string_view
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp > _If_sv< _Tp, basic_string & > std::basic_string<
_CharT, _Traits, _Alloc >::replace (const_iterator __i1, const_iterator
__i2, const _Tp & __svt) [inline], [inherited]Replace range of characters with string_view. Out with the old, in with the view. ✨
Parameters
__i1— An iterator referencing the start position to replace at.__i2— An iterator referencing the end position for the replace.__svt— The object convertible tostring_viewto insert from.
Returns
Reference to this string.
References std::basic_string< _CharT, _Traits, _Alloc >::begin(), and std::basic_string< _CharT, _Traits, _Alloc >::replace().
🌸 replace() — the glow-up function, iterator edition 💅
template<typename _CharT , typename _Traits , typename _Alloc >
template<class _InputIterator >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2, _InputIterator __k1, _InputIterator __k2)
[inline], [inherited]Okay bestie, this one is literally "replace a range of characters with a range" ✨ — swapping out a chunk for a whole other chunk, no cap.
- Parameters
__i1— iterator pointing at the start of the range you're replacing.__i2— iterator pointing at the end of the range you're replacing.__k1— iterator pointing at the start of the range you're inserting.__k2— iterator pointing at the end of the range you're inserting.
- Returns — a reference to this string 🫶
- Exceptions —
std::length_errorif the new length exceedsmax_size().
So what actually happens: the characters in the range [__i1,__i2) get removed. Then, in place, the characters in [__k1,__k2) get inserted. If the resulting length blows past max_size(), length_error is thrown. And the bestie-safe part: the value of the string doesn't change if an error is thrown 💖. Nothing half-done, nothing messy.
🎀 replace() — same energy, but with a C string
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2, const _CharT * __s) [inline], [inherited]Replace a range of characters with a C string, iconic behaviour only.
- Parameters
__i1— iterator referencing start of range to replace.__i2— iterator referencing end of range to replace.__s— the C string value to insert.
- Returns — reference to this string.
- Exceptions —
std::length_errorif new length exceedsmax_size().
Removes the characters in [__i1,__i2), and in place the characters of __s get inserted. Length overflow → length_error. Error thrown → string value untouched. Periodt.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace().
🦋 replace() — the C substring one (now with a length count)
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2, const _CharT * __s, size_type __n)
[inline], [inherited]"Replace range of characters with C substring" — yes, that's the whole vibe.
- Parameters
__i1— iterator referencing start of range to replace.__i2— iterator referencing end of range to replace.__s— C string value to insert.__n— number of characters fromsto insert.
- Returns — reference to this string.
- Exceptions —
std::length_errorif new length exceedsmax_size().
Removes the characters in [__i1,__i2), then in place the first __n characters of __s get inserted. If the result is longer than max_size(), length_error gets yeeted at you. And once again: value unchanged if an error is thrown 🙈.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace().
💜 replace() — swapping in another basic_string
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2,
const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]Replace range of characters with string — simple, clean, slay.
- Parameters
__i1— iterator referencing start of range to replace.__i2— iterator referencing end of range to replace.__str— string value to insert.
- Returns — reference to this string.
- Exceptions —
std::length_errorif new length exceedsmax_size().
Characters in [__i1,__i2) are gone, the value of __str slides in instead, and if that makes the length exceed max_size() you get a length_error. Error → string value stays exactly as it was, no notes.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
🍓 replace() — the initializer_list cutie
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2, initializer_list< _CharT > __l)
[inline], [inherited]Replace range of characters with initializer_list — feeding it a lil squad of chars 🧚♀️
- Parameters
__i1— iterator referencing start of range to replace.__i2— iterator referencing end of range to replace.__l— theinitializer_listof characters to insert.
- Returns — reference to this string.
- Exceptions —
std::length_errorif new length exceedsmax_size().
Removes the characters in [__i1,__i2). In place, characters in the range [__k1,__k2) are inserted. 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.
🙈 okay real talk — yes, this overload's description literally mentions[__k1,__k2)even though this signature has no__k1/__k2anywhere. That's the docs' own copy-paste moment, so we're reporting it exactly as written, no edits, no gaslighting. Keeping it 100 with the source 💀
References: std::basic_string< _CharT, _Traits, _Alloc >::replace().
🔥 replace() — n copies of one character, the fill situation
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(iterator __i1, iterator __i2, size_type __n, _CharT __c)
[inline], [inherited]Replace range of characters with multiple characters ✨
- 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_errorif new length exceedsmax_size().
Characters in [__i1,__i2) get removed, and in their place you get __n copies of __c. Length goes over max_size() → length_error. Error thrown → value stays put, untouched, immaculate.
🌈 replace() — the string_view era (_If_sv, position + count version)
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::replace
(size_type __pos, size_type __n, const _Tp & __svt) [inline], [inherited]Replace range of characters with string_view — flexible bestie energy 🦋
- Parameters
__pos— the position to replace at.__n— the number of characters to replace.__svt— the object convertible tostring_viewto insert.
- Returns — reference to this string.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace().
👑 replace() — position-based, string in, range out
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(size_type __pos, size_type __n,
const basic_string< _CharT, _Traits, _Alloc > & __str) [inline], [inherited]Replace characters with value from another string — the classic ✨
- 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_rangeif pos is beyond the end of this string.std::length_errorif new length exceedsmax_size().
Removes the characters in the range [__pos,__pos+__n) from this string, and in place the value of __str is inserted. If __pos is beyond the end of the string, out_of_range is thrown. If the length of the result exceeds max_size(), length_error is thrown. And the value of the string doesn't change if an error is thrown 💖.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
Referenced by — okay this list is long, buckle up 🎢: std::basic_string< _CharT, _Traits, _Alloc >::append(), std::basic_string< _CharT, _Traits, _Alloc >::assign(), std::basic_string< _CharT, _Traits, _Alloc >::insert() (three times), and then std::basic_string< _CharT, _Traits, _Alloc >::replace() a full ten more times. Yeah. Ten. That's the whole overload set calling back home. Main character energy fr fr.
🫶 replace() — string_view again, but with a source offset this time
template<typename _CharT , typename _Traits , typename _Alloc >
template<typename _Tp >
_If_sv< _Tp, basic_string & > std::basic_string< _CharT, _Traits, _Alloc >::replace
(size_type __pos1, size_type __n1, const _Tp & __svt, size_type __pos2,
size_type __n2 = npos) [inline], [inherited]Replace range of characters with string_view — but picky about where in the view you start 👀
- Parameters
__pos1— the position to replace at.__n1— the number of characters to replace.__svt— the object convertible tostring_viewto insert from.__pos2— the position in thestring_viewto insert from.__n2— the number of characters to insert.
- Returns — reference to this string.
References: std::basic_string< _CharT, _Traits, _Alloc >::replace().
💀 replace() — two positions, two counts, maximum drama
template<typename _CharT , typename _Traits , typename _Alloc >
basic_string & std::basic_string< _CharT, _Traits, _Alloc >::replace
(size_type __pos1, size_type __n1,
const basic_string< _CharT, _Traits, _Alloc > & __str,
size_type __pos2, size_type __n2 = npos) [inline], [inherited]Replace characters with value from another string — the fully-specified version, 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_rangeif__pos1 > size()or__pos2 > __str.size().std::length_errorif new length exceedsmax_size().
Removes the characters in the range [__pos1,__pos1 + n) from this string, and in place the value of __str is inserted. If __pos is beyond the end of the 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: std::basic_string< _CharT, _Traits, _Alloc >::replace().
🎀 reserve() — the no-arg one, and it's a little plot twist
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
void std::basic_string< _CharT, _Traits, _Alloc >::reserve ()Equivalent to shrink_to_fit().
That's it. That's the whole description. Not me expecting it to reserve anything 😭 — no cap, it shrinks. Read it twice, bestie.
⭐ reserve(size_type __res_arg) — this one actually reserves
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>>
void std::basic_string< _CharT, _Traits, _Alloc >::reserve (size_type __res_arg)Attempt to preallocate enough memory for specified number of characters — the responsible, forward-thinking icon behaviour 👑
- Parameters
__res_arg— number of characters required.
- Exceptions —
std::length_errorif__res_argexceedsmax_size().
So this function attempts to reserve enough memory for the string to hold the specified number of characters. If the number you asked for is more than max_size(), length_error is thrown.
The advantage, and this is genuinely the good part: if optimal code is a necessity and you, the user, can determine the string length that will be required, you can reserve the memory in advance — and thus prevent a possible reallocation of memory and copying of string data. Chef's kiss. No more surprise realloc mid-loop. We love a plan 💖
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::rfind (_CharT __c, size_type __pos = npos) const [noexcept]find the last position of a character, bestie ✨ — this overload is on the hunt for one single character, and it goes backwards from __pos.
Parameters
__c— the character you're locating 👀__pos— the index of the character to search back from (defaults to the end, obvs)
Returns
The index of the last occurrence. That's it, that's the tea.
Starting from __pos, it searches backward for __c within this string. Found it? Slay, you get the index where it was found. Not found? npos. Periodt. 💅
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> basic_string< _CharT,
_Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits, _Alloc
>::rfind (const _CharT * __s, size_type __pos, size_type __n) const
[noexcept]find the last position of a C substring 🦋 — this one's like the character version but it's matching a whole little crew of __n characters.
Parameters
__s— the C string to locate 🎯__pos— the index of the character to search back from__n— how many characters fromsto search for (yes, the parameter doc literally sayss, we don't make the rules 🫠)
Returns
The index of the start of the last occurrence, gorgeous. 👑
Starting from __pos, it searches backward for the first __n characters in __s within this string. If found, it returns the index where it begins. If not found, it returns npos. No cap. 💀
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::rfind (const _CharT * __s,
size_type __pos = npos) const [inline], [noexcept]find the last position of a C string 🌸 — the whole-C-string edition, [inline] and [noexcept] because she's efficient and she does not throw.
Parameters
__s— the C string to locate 🍓__pos— the index of the character to start the search at (defaults to the end, iykyk)
Returns
The index of the start of the last occurrence. 💖
Starting from __pos, it searches backward for the value of __s within this string. Found it? Here's the index where it begins. Not found? npos. Same energy as always, fr fr.
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> template<typename _Tp >
_If_sv< _Tp, size_type > std::basic_string< _CharT, _Traits, _Alloc
>::rfind (const _Tp & __svt, size_type __pos = npos) const [inline],
[noexcept]find the last position of a string_view 🧚 — template-on-template, she's fancy like that. Also [inline] and [noexcept].
Parameters
__svt— the object convertible tostring_viewto locate 🌈__pos— the index of the character to search back from (default end, bestie)
Returns
The index of the start of the last occurrence. 🎀 (That's all the docs give us on this one — no extra description, so I'm not gonna invent one, ngl.)
template<typename _CharT , typename _Traits , typename _Alloc > size_type
std::basic_string< _CharT, _Traits, _Alloc >::rfind (const basic_string<
_CharT, _Traits, _Alloc > & __str, size_type __pos = npos) const
[inline], [noexcept], [inherited]find the last position of a string ⭐ — note the [inherited] tag, she got this from the base class and she's thriving.
Parameters
__str— the string to locate 🔥__pos— the index of the character to search back from (default end)
Returns
The index of the start of the last occurrence. 💜
Starting from __pos, it searches backward for the value of __str within this string. If found, it returns the index where it begins. If not found, it returns npos. 💅
References std::basic_string< _CharT, _Traits, _Alloc >::data(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), and std::basic_string< _CharT, _Traits, _Alloc >::size().
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::find_last_of(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), std::basic_string< _CharT, _Traits, _Alloc >::rfind(), and std::basic_string< _CharT, _Traits, _Alloc >::rfind(). (Yes, rfind references rfind — it's giving recursion energy, we love to see it 🙈)
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::rfind (const basic_string<
_CharT, _Traits, _Allocator > & __str, size_type __pos = npos) const
[inline], [noexcept]find the last position of a string 🦋 — the non-inherited twin, template params spelled the long way with _Allocator. [inline], [noexcept], iconic.
Parameters
__str— the string to locate 👑__pos— the index of the character to search back from (default end)
Returns
The index of the start of the last occurrence. ✨
Starting from __pos, it searches backward for the value of __str within this string. If found, it returns the index where it begins. If not found, it returns npos.
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> size_type
std::basic_string< _CharT, _Traits, _Alloc >::size () const [inline],
[noexcept]size() — returns the number of characters in the string, not including any null-termination. Luv, the null terminator is not being counted, it's not invited to the party. 🎉 [inline], [noexcept], tiny but mighty.
template<typename _CharT , typename _Traits , typename _Alloc > void
std::basic_string< _CharT, _Traits, _Alloc >::swap (basic_string<
_CharT, _Traits, _Alloc > & __s) [noexcept], [inherited]swap contents with another string 🌿 — [noexcept], [inherited], and honestly kind of a flex.
Parameters
__s— the string to swap with 🫶
Exchanges the contents of this string with that of __s in constant time. Constant time!! She's not copying anything, she's just swapping the vibes. 😭🔥
Referenced by std::basic_string< _CharT, _Traits, _Alloc >::assign(), and std::basic_string< _CharT, _Traits, _Alloc >::operator=().
🫶 MEMBER DATA DOCUMENTATION 🫶
template<typename _CharT , typename _Traits = std::char_traits<_CharT>,
typename _Allocator = std::allocator<_CharT>> const basic_string<
_CharT, _Traits, _Alloc >::size_type std::basic_string< _CharT, _Traits,
_Alloc >::npos [static]npos[static] — the value returned by various member functions when they fail. 💀 She's the "it didn't work out babe" constant, the static queen of not-found, and we respect her.
💖 AUTHOR 💖
Generated automatically by Doxygen for libstdc++ from the source code. Not a human, just a little robot doing its absolute best. 🤖✨
Ok bestie, that's the whole page, start to finish — every flag, every param, every npos, all of it. 🎀
And for the sign-off: this lil' masterpiece is a libstdc++ man page, and the footer lexes as libst__gnu_debug::ba...s, _Allocator >(3cxx) (yes the name got absolutely bodied by truncation, she's mysterious now 🙈). Take care of her, cite the version, and go write some strings. Mwah! 💅💜🦋
📦 where this page comes from
- ubuntu noble: libstdc++-14-doc 14-20240412-0ubuntu1
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms