qx::basic_string< char_t, traits_t > Class Template Reference

String class. More...

#include <string.h>

Public Member Functions
	basic_string (size_type nSymbols, value_type chSymbol) noexcept
	basic_string object constructor More...
	basic_string (const_pointer pszSource, size_type nSymbols) noexcept
	basic_string object constructor More...
	basic_string (const_pointer pszSource) noexcept
	basic_string object constructor More...
	basic_string (basic_string &&sAnother) noexcept
	basic_string object constructor More...
	basic_string (const basic_string &sAnother) noexcept
	basic_string object constructor More...
template<class fwd_it_t >
	basic_string (fwd_it_t itFirst, fwd_it_t itLast) noexcept
	basic_string object constructor More...
template<range_of_t_c< char_t > string_t>
	basic_string (const string_t &sAnother) noexcept
	basic_string object constructor More...
void	assign (size_type nSymbols, value_type chSymbol) noexcept
	Assign by filling. More...
void	assign (const_pointer pszSource, size_type nSymbols) noexcept
	Assign by char sequence. More...
void	assign (const_pointer pszSource) noexcept
	Assign by psz. More...
void	assign (basic_string &&sAnother) noexcept
	Assign by moving from another string. More...
void	assign (const basic_string &sAnother) noexcept
	Assign by another string. More...
template<class fwd_it_t >
void	assign (fwd_it_t itFirst, fwd_it_t itLast) noexcept
	Assign by iterators. More...
template<range_of_t_c< char_t > string_t>
void	assign (const string_t &str) noexcept
	Assign by char container. More...
template<class... args_t>
requires format_acceptable_args< char_t, args_t... > void	format (const format_string_type< std::type_identity_t< args_t >... > sFormat, args_t &&... args)
	Clear the string and format it with the format string and the args. More...
template<class... args_t>
requires format_acceptable_args< char_t, args_t... > void	append_format (const format_string_type< std::type_identity_t< args_t >... > sFormat, args_t &&... args)
	Append the formatted string to the current one. More...
template<class... args_t>
requires format_acceptable_args< char_t, args_t... > void	vformat (string_view svFormat, args_t &&... args)
	Clear the string and format it with the format string and the args. More...
template<class... args_t>
requires format_acceptable_args< char_t, args_t... > void	append_vformat (string_view svFormat, args_t &&... args)
	Append the formatted string to the current one. More...
void	swap (basic_string &sOther) noexcept
	Swap this str and other. More...
size_type	reserve (size_type nCapacity) noexcept
	Reserve memory for the string. More...
void	shrink_to_fit () noexcept
	Fit allocated size to string's actual size.
void	free () noexcept
	Clear string and free allocated memory.
string_view	substr (size_type nPos, size_type nSymbols=npos) const noexcept
	Get substring. More...
void	to_lower () noexcept
	Convert string to lowercase.
void	to_upper () noexcept
	Convert string to uppercase.
value_type	front () const noexcept
	Get first char of the string. More...
value_type	back () const noexcept
	Get last char of the string. More...
size_type	length () const noexcept
	Get string length. More...
const_pointer	c_str () const noexcept
	Get pointer to string zero terminated. More...
size_type	capacity () const noexcept
	Get allocated memory size (including null terminator) More...
template<class to_t >
std::optional< to_t >	to (const_pointer pszFormat=nullptr) const noexcept
	Convert string to specified type. More...
size_type	copy (pointer pDest, size_type nCount, size_type nPos=0) const noexcept
	Copies a substring [nPos, nPos + nCount) to character string pointed to by pDest. More...
template<class from_t >
void	from (const from_t &data)
	Construct string from custom type. More...
void	append (value_type chSymbol) noexcept
	Append char. More...
void	append (const_pointer pszStr, size_type nStrSize=npos) noexcept
	Append string. More...
void	append (const basic_string &sStr) noexcept
	Append string. More...
template<class fwd_it_t >
void	append (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Append string. More...
template<range_of_t_c< char_t > string_t>
void	append (const string_t &sStr) noexcept
	Append string. More...
size_type	insert (size_type nPos, value_type chSymbol) noexcept
	Insert substring. More...
size_type	insert (size_type nPos, const_pointer pszWhat, size_type nSymbols=npos) noexcept
	Insert substring. More...
size_type	insert (size_type nPos, const basic_string &sWhat) noexcept
	Insert substring. More...
template<class fwd_it_t >
size_type	insert (size_type nPos, fwd_it_t itWhatBegin, fwd_it_t itWhatEnd) noexcept
	Insert substring. More...
template<range_of_t_c< char_t > string_t>
size_type	insert (size_type nPos, string_t sWhat) noexcept
	Insert substring. More...
size_type	insert (const_iterator itPos, value_type chSymbol) noexcept
	Insert char. More...
size_type	insert (const_iterator itPos, const_pointer pszWhat, size_type nSymbols=npos) noexcept
	Insert substring. More...
size_type	insert (const_iterator itPos, const basic_string &sWhat) noexcept
	Insert substring. More...
template<class fwd_it_t >
size_type	insert (const_iterator itPos, fwd_it_t itWhatBegin, fwd_it_t itWhatEnd) noexcept
	Insert substring. More...
template<range_of_t_c< char_t > string_t>
size_type	insert (const_iterator itPos, string_t sWhat) noexcept
	Insert substring. More...
void	push_back (value_type chSymbol) noexcept
	Insert char in the end of the string. More...
void	push_front (value_type chSymbol) noexcept
	Insert char in the beginning of the string. More...
void	erase (iterator itFirst, iterator itLast) noexcept
	Erase substring. More...
void	erase (iterator itPos) noexcept
	Erase on iterator. More...
void	erase (size_type nPos) noexcept
	Erase on position. More...
void	erase (size_type nPos, size_type nSymbols) noexcept
	Erase substring. More...
value_type	pop_back () noexcept
	Erase last char and return it. More...
value_type	pop_front () noexcept
	Erase first char and return it. More...
size_type	trim_left () noexcept
	Trim the string to the left (whitespace characters) More...
size_type	trim_left (value_type chSymbol) noexcept
	Trim the string to the left. More...
size_type	trim_left (const_pointer pszStr) noexcept
	Trim the string to the left. More...
size_type	trim_left (const_pointer pszStr, size_type nStrSize) noexcept
	Trim the string to the left. More...
size_type	trim_left (const basic_string &sStr) noexcept
	Trim the string to the left. More...
template<class fwd_it_t >
size_type	trim_left (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Trim the string to the left. More...
template<range_of_t_c< char_t > string_t>
size_type	trim_left (const string_t &sStr) noexcept
	Trim the string to the left. More...
size_type	trim_right () noexcept
	Trim the string to the right (whitespace characters) More...
size_type	trim_right (value_type chSymbol) noexcept
	Trim the string to the right. More...
size_type	trim_right (const_pointer pszStr) noexcept
	Trim the string to the right. More...
size_type	trim_right (const_pointer pszStr, size_type nStrSize) noexcept
	Trim the string to the right. More...
size_type	trim_right (const basic_string &sStr) noexcept
	Trim the string to the right. More...
template<class fwd_it_t >
size_type	trim_right (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Trim the string to the right. More...
template<range_of_t_c< char_t > string_t>
size_type	trim_right (const string_t &sStr) noexcept
	Trim the string to the right. More...
size_type	trim () noexcept
	Trim the string to the both sides (whitespace characters) More...
size_type	trim (value_type chSymbol) noexcept
	Trim the string to the both sides. More...
size_type	trim (const_pointer pszStr) noexcept
	Trim the string to the both sides. More...
size_type	trim (const_pointer pszStr, size_type nStrSize) noexcept
	Trim the string to the both sides. More...
size_type	trim (const basic_string &sStr) noexcept
	Trim the string to the both sides. More...
template<class fwd_it_t >
size_type	trim (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Trim the string to the both sides. More...
template<range_of_t_c< char_t > string_t>
size_type	trim (const string_t &sStr) noexcept
	Trim the string to the both sides. More...
size_type	remove (value_type chSymbol, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove the first occurrence of a substring in a string. More...
size_type	remove (const_pointer pszStr, size_type nBegin=0, size_type nEnd=npos, size_type nStrSize=npos) noexcept
	Remove the first occurrence of a substring in a string. More...
size_type	remove (const basic_string &sStr, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove the first occurrence of a substring in a string. More...
template<class fwd_it_t >
size_type	remove (fwd_it_t itBegin, fwd_it_t itEnd, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove the first occurrence of a substring in a string. More...
template<range_of_t_c< char_t > string_t>
size_type	remove (const string_t &sStr, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove the first occurrence of a substring in a string. More...
bool	remove_prefix (value_type chSymbol) noexcept
	Remove string prefix if matches. More...
bool	remove_prefix (const_pointer pszStr, size_type nStrSize=npos) noexcept
	Remove string prefix if matches. More...
bool	remove_prefix (const basic_string &sStr) noexcept
	Remove string prefix if matches. More...
template<class fwd_it_t >
bool	remove_prefix (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Remove string prefix if matches. More...
template<range_of_t_c< char_t > string_t>
bool	remove_prefix (const string_t &sStr) noexcept
	Remove string prefix if matches. More...
bool	remove_suffix (value_type chSymbol) noexcept
	Remove string suffix if matches. More...
bool	remove_suffix (const_pointer pszStr, size_type nStrSize=npos) noexcept
	Remove string suffix if matches. More...
bool	remove_suffix (const basic_string &sStr) noexcept
	Remove string suffix if matches. More...
template<class fwd_it_t >
bool	remove_suffix (fwd_it_t itBegin, fwd_it_t itEnd) noexcept
	Remove string suffix if matches. More...
template<range_of_t_c< char_t > string_t>
bool	remove_suffix (const string_t &sStr) noexcept
	Remove string suffix if matches. More...
size_type	remove_all (value_type chSymbol, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove all occurrences of a substring in a string. More...
size_type	remove_all (const_pointer pszStr, size_type nBegin=0, size_type nEnd=npos, size_type nStrSize=npos) noexcept
	Remove all occurrences of a substring in a string. More...
size_type	remove_all (const basic_string &sStr, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove all occurrences of a substring in a string. More...
template<class fwd_it_t >
size_type	remove_all (fwd_it_t itFirst, fwd_it_t itLast, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove all occurrences of a substring in a string. More...
template<range_of_t_c< char_t > string_t>
size_type	remove_all (const string_t &sStr, size_type nBegin=0, size_type nEnd=npos) noexcept
	Remove all occurrences of a substring in a string. More...
template<class find_string_t , class replace_string_t >
size_type	replace (const find_string_t &sFind, const replace_string_t &sReplace, size_type nBegin=0, size_type nEnd=npos) noexcept
	Replace first occurrence of sFind with sReplace. More...
template<class find_string_t , class replace_string_t >
size_type	replace_all (const find_string_t &sFind, const replace_string_t &sReplace, size_type nBegin=0, size_type nEnd=npos) noexcept
	Replace all occurrences of sFind with sReplace. More...
int	compare (value_type chSymbol) const noexcept
	Performs a binary comparison of the characters. More...
int	compare (const_pointer pszStr) const noexcept
	Performs a binary comparison of the characters. More...
int	compare (const_pointer pStr, size_type nStrSize) const noexcept
	Performs a binary comparison of the characters. More...
int	compare (const basic_string &sStr) const noexcept
	Performs a binary comparison of the characters. More...
template<class fwd_it_t >
int	compare (fwd_it_t itBegin, fwd_it_t itEnd) const noexcept
	Performs a binary comparison of the characters. More...
template<range_of_t_c< char_t > string_t>
int	compare (const string_t &sStr) const noexcept
	Performs a binary comparison of the characters. More...
size_type	find (value_type chSymbol, size_type nBegin=0, size_type nEnd=npos) const noexcept
	Find substring. More...
size_type	find (const_pointer pszWhat, size_type nBegin=0, size_type nWhatSize=npos, size_type nEnd=npos) const noexcept
	Find substring. More...
size_type	find (const basic_string &sWhat, size_type nBegin=0, size_type nEnd=npos) const noexcept
	Find substring. More...
template<class fwd_it_t >
size_type	find (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nBegin=0, size_type nEnd=npos) const noexcept
	Find substring. More...
template<range_of_t_c< char_t > string_t>
size_type	find (string_t sWhat, size_type nBegin=0, size_type nEnd=npos) const noexcept
	Find substring. More...
size_type	rfind (value_type chSymbol, size_type nBegin=npos, size_type nEnd=0) const noexcept
	Find substring (reverse direction) More...
size_type	rfind (const_pointer pszWhat, size_type nBegin=npos, size_type nWhatSize=npos, size_type nEnd=0) const noexcept
	Find substring (reverse direction) More...
size_type	rfind (const basic_string &sWhat, size_type nBegin=npos, size_type nEnd=0) const noexcept
	Find substring (reverse direction) More...
template<class fwd_it_t >
size_type	rfind (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nBegin=npos, size_type nEnd=0) const noexcept
	Find substring (reverse direction) More...
template<range_of_t_c< char_t > string_t>
size_type	rfind (string_t sWhat, size_type nBegin=npos, size_type nEnd=0) const noexcept
	Find substring (reverse direction) More...
size_type	find_first_of (value_type chSymbol, size_type nBegin=0) const noexcept
	Find first position of character. More...
size_type	find_first_of (const_pointer pszWhat, size_type nBegin, size_type nWhatSize) const noexcept
	Finds the first character equal to one of characters in the given character sequence. More...
size_type	find_first_of (const_pointer pszWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to one of characters in the given character sequence. More...
size_type	find_first_of (const basic_string &sWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to one of characters in the given character sequence. More...
template<class fwd_it_t >
size_type	find_first_of (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nBegin=0) const noexcept
	Finds the first character equal to one of characters in the given character sequence. More...
template<range_of_t_c< char_t > string_t>
size_type	find_first_of (string_t sWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to one of characters in the given character sequence. More...
size_type	find_last_of (value_type chSymbol, size_type nEnd=0) const noexcept
	Find last position of character. More...
size_type	find_last_of (const_pointer pszWhat, size_type nEnd, size_type nWhatSize) const noexcept
	Finds the last character equal to one of characters in the given character sequence. More...
size_type	find_last_of (const_pointer pszWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to one of characters in the given character sequence. More...
size_type	find_last_of (const basic_string &sWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to one of characters in the given character sequence. More...
template<class fwd_it_t >
size_type	find_last_of (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nEnd=0) const noexcept
	Finds the last character equal to one of characters in the given character sequence. More...
template<range_of_t_c< char_t > string_t>
size_type	find_last_of (string_t sWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to one of characters in the given character sequence. More...
size_type	find_first_not_of (value_type chSymbol, size_type nBegin=0) const noexcept
	Finds the first character not equal to chSymbol. More...
size_type	find_first_not_of (const_pointer pszWhat, size_type nBegin, size_type nWhatSize) const noexcept
	Finds the first character equal to none of the characters in the given character sequence. More...
size_type	find_first_not_of (const_pointer pszWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to none of the characters in the given character sequence. More...
size_type	find_first_not_of (const basic_string &sWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to none of the characters in the given character sequence. More...
template<class fwd_it_t >
size_type	find_first_not_of (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nBegin=0) const noexcept
	Finds the first character equal to none of the characters in the given character sequence. More...
template<range_of_t_c< char_t > string_t>
size_type	find_first_not_of (string_t sWhat, size_type nBegin=0) const noexcept
	Finds the first character equal to none of the characters in the given character sequence. More...
size_type	find_last_not_of (value_type chSymbol, size_type nEnd=0) const noexcept
	Finds the last character not equal to chSymbol. More...
size_type	find_last_not_of (const_pointer pszWhat, size_type nEnd, size_type nWhatSize) const noexcept
	Finds the last character equal to none of the characters in the given character sequence. More...
size_type	find_last_not_of (const_pointer pszWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to none of the characters in the given character sequence. More...
size_type	find_last_not_of (const basic_string &sWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to none of the characters in the given character sequence. More...
template<class fwd_it_t >
size_type	find_last_not_of (fwd_it_t itWhatBegin, fwd_it_t itWhatEnd, size_type nEnd=0) const noexcept
	Finds the last character equal to none of the characters in the given character sequence. More...
template<range_of_t_c< char_t > string_t>
size_type	find_last_not_of (string_t sWhat, size_type nEnd=0) const noexcept
	Finds the last character equal to none of the characters in the given character sequence. More...
views	split (const value_type chSeparator) const noexcept
	Split string by separator. More...
views	split (const_pointer pszSeparator, size_type nSepLen=npos) const noexcept
	Split string by separator. More...
views	split (const basic_string &sSeparator) const noexcept
	Split string by separator. More...
template<class fwd_it_t >
views	split (fwd_it_t itSepFirst, fwd_it_t itSepLast) const noexcept
	Split string by separator. More...
template<range_of_t_c< char_t > string_t>
views	split (const string_t &sSeparator) const noexcept
	Split string by separator. More...
bool	starts_with (value_type chSymbol) const noexcept
	Check if current string starts with char. More...
bool	starts_with (const_pointer pszStr, size_type nStrSize=npos) const noexcept
	Check if current string starts with string. More...
bool	starts_with (const basic_string &sStr) const noexcept
	Check if current string starts with string. More...
template<class fwd_it_t >
bool	starts_with (fwd_it_t itBegin, fwd_it_t itEnd) const noexcept
	Check if current string starts with string. More...
template<range_of_t_c< char_t > string_t>
bool	starts_with (const string_t &sStr) const noexcept
	Check if current string starts with string. More...
bool	ends_with (value_type chSymbol) const noexcept
	Check if current string ends with char. More...
bool	ends_with (const_pointer pszStr, size_type nStrSize=npos) const noexcept
	Check if current string ends with string. More...
bool	ends_with (const basic_string &sStr) const noexcept
	Check if current string ends with string. More...
template<class fwd_it_t >
bool	ends_with (fwd_it_t itBegin, fwd_it_t itEnd) const noexcept
	Check if current string ends with string. More...
template<range_of_t_c< char_t > string_t>
bool	ends_with (const string_t &sStr) const noexcept
	Check if current string ends with string. More...
bool	contains (value_type chSymbol) const noexcept
	Check if string contains char. More...
bool	contains (const_pointer pszStr, size_type nStrSize=npos) const noexcept
	Check if string contains substring. More...
bool	contains (const basic_string &sStr) const noexcept
	Check if string contains substring. More...
template<class fwd_it_t >
bool	contains (fwd_it_t itBegin, fwd_it_t itEnd) const noexcept
	Check if string contains substring. More...
template<range_of_t_c< char_t > string_t>
bool	contains (const string_t &sStr) const noexcept
	Check if string contains substring. More...

Static Public Member Functions
template<class... args_t>
requires static format_acceptable_args< char_t, args_t... > basic_string	static_format (const format_string_type< std::type_identity_t< args_t >... > sFormat, args_t &&... args)
	Create a string by formatting it with the format string and the args. More...
template<class... args_t>
requires static format_acceptable_args< char_t, args_t... > basic_string	static_vformat (string_view svFormat, args_t &&... args)
	Create a string by formatting it with the format string and the args. More...
static constexpr size_type	max_size () noexcept
	Get the theoretical maximum of string size. More...
template<class from_t >
static basic_string	static_from (const from_t &data)
	Construct string from custom type and get it. More...

Detailed Description

template<class char_t, class traits_t>
class qx::basic_string< char_t, traits_t >

String class.

A class containing a null-terminated character sequence. Supports small strings optimization, almost completely supports the std::string interface (except for some overloads), has many additional methods for convenient working with strings.

Template Parameters

char_t	- char type (char, wchar_t, etc)
traits_t	- char traits.

See also

string_traits.h

Author

Khrapov

Date

20.10.2019

Definition at line 63 of file string.h.

Constructor & Destructor Documentation

basic_string() [1/7]

template<class char_t , class traits_t >

qx::basic_string< char_t, traits_t >::basic_string ( size_type  nSymbols, value_type  chSymbol  )

inlinenoexcept

basic_string object constructor

Parameters

nSymbols	- number of same chars
chSymbol	- char to assign

Definition at line 14 of file string.inl.

basic_string() [2/7]

template<class char_t , class traits_t >

qx::basic_string< char_t, traits_t >::basic_string ( const_pointer  pszSource, size_type  nSymbols  )

inlinenoexcept

basic_string object constructor

Parameters

pszSource	- source string pointer
nSymbols	- source string size

Definition at line 20 of file string.inl.

basic_string() [3/7]

template<class char_t , class traits_t >

qx::basic_string< char_t, traits_t >::basic_string ( const_pointer  pszSource )

inlinenoexcept

basic_string object constructor

Parameters

pszSource

- source string pointer

Definition at line 26 of file string.inl.

basic_string() [4/7]

template<class char_t , class traits_t >

qx::basic_string< char_t, traits_t >::basic_string ( basic_string< char_t, traits_t > &&  sAnother )

inlinenoexcept

basic_string object constructor

Parameters

sAnother

- another string rvalue ref

Definition at line 32 of file string.inl.

basic_string() [5/7]

template<class char_t , class traits_t >

qx::basic_string< char_t, traits_t >::basic_string ( const basic_string< char_t, traits_t > &  sAnother )

inlinenoexcept

basic_string object constructor

Parameters

sAnother

- another string

Definition at line 38 of file string.inl.

basic_string() [6/7]

template<class char_t , class traits_t >

template<class fwd_it_t >

qx::basic_string< char_t, traits_t >::basic_string ( fwd_it_t  itFirst, fwd_it_t  itLast  )

inlinenoexcept

basic_string object constructor

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itFirst	- first source iterator
itLast	- last source iterator

Definition at line 45 of file string.inl.

basic_string() [7/7]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

qx::basic_string< char_t, traits_t >::basic_string ( const string_t &  sAnother )

inlinenoexcept

basic_string object constructor

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sAnother

- string-ish container

Definition at line 52 of file string.inl.

Member Function Documentation

append() [1/5]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::append ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Append string.

Parameters

sStr	- source string

Definition at line 395 of file string.inl.

append() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

void qx::basic_string< char_t, traits_t >::append ( const string_t &  sStr )

inlinenoexcept

Append string.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- source char container

Definition at line 410 of file string.inl.

append() [3/5]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::append ( const_pointer  pszStr, size_type  nStrSize = npos  )

inlinenoexcept

Append string.

Parameters

pszStr	- source string
nStrSize	- source string size

Definition at line 382 of file string.inl.

append() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

void qx::basic_string< char_t, traits_t >::append ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Append string.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- other string begin iterator
itEnd	- other end begin iterator

Definition at line 402 of file string.inl.

append() [5/5]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::append ( value_type  chSymbol )

inlinenoexcept

Append char.

Parameters

chSymbol

- char to append

Definition at line 376 of file string.inl.

append_format()

template<class char_t , class traits_t >

template<class... args_t>

requires format_acceptable_args< char_t, args_t... > void qx::basic_string< char_t, traits_t >::append_format	(	const format_string_type< std::type_identity_t< args_t >... >	sFormat,
		args_t &&...	args
	)

Append the formatted string to the current one.

Format string will be checked at compile time

Template Parameters

args_t

- template parameter pack type

Parameters

sFormat	- format string
args	- format arguments

Definition at line 145 of file string.inl.

append_vformat()

template<class char_t , class traits_t >

template<class... args_t>

requires format_acceptable_args< char_t, args_t... > void qx::basic_string< char_t, traits_t >::append_vformat ( string_view  svFormat, args_t &&...  args  )

inline

Append the formatted string to the current one.

No compile time checks, method will throw is something is wrong with the format string

Template Parameters

args_t

- template parameter pack type

Parameters

svFormat	- format string
args	- format arguments

Definition at line 176 of file string.inl.

assign() [1/7]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::assign ( basic_string< char_t, traits_t > &&  sAnother )

inlinenoexcept

Assign by moving from another string.

Parameters

sAnother

- another string

Definition at line 85 of file string.inl.

assign() [2/7]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::assign ( const basic_string< char_t, traits_t > &  sAnother )

inlinenoexcept

Assign by another string.

Parameters

sAnother

- another string

Definition at line 91 of file string.inl.

assign() [3/7]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

void qx::basic_string< char_t, traits_t >::assign ( const string_t &  str )

inlinenoexcept

Assign by char container.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

str	- char container

Definition at line 117 of file string.inl.

assign() [4/7]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::assign ( const_pointer  pszSource )

inlinenoexcept

Assign by psz.

Parameters

pszSource

- pointer to zero terminated char sequence

Definition at line 78 of file string.inl.

assign() [5/7]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::assign ( const_pointer  pszSource, size_type  nSymbols  )

inlinenoexcept

Assign by char sequence.

Parameters

pszSource	- pointer to char sequence
nSymbols	- num of chars

Definition at line 71 of file string.inl.

assign() [6/7]

template<class char_t , class traits_t >

template<class fwd_it_t >

void qx::basic_string< char_t, traits_t >::assign ( fwd_it_t  itFirst, fwd_it_t  itLast  )

inlinenoexcept

Assign by iterators.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itFirst	- first iterator of source
itLast	- last iterator of source

Definition at line 99 of file string.inl.

assign() [7/7]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::assign ( size_type  nSymbols, value_type  chSymbol  )

inlinenoexcept

Assign by filling.

Parameters

nSymbols	- number of same chars
chSymbol	- char to assign

Definition at line 64 of file string.inl.

back()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::value_type qx::basic_string< char_t, traits_t >::back

inlinenoexcept

Get last char of the string.

Return values

-	last char of the string

Definition at line 240 of file string.inl.

c_str()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::const_pointer qx::basic_string< char_t, traits_t >::c_str

inlinenoexcept

Get pointer to string zero terminated.

Return values

-	pointer to string zero terminated

Definition at line 252 of file string.inl.

capacity()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::capacity

inlinenoexcept

Get allocated memory size (including null terminator)

Return values

-	allocated memory size

Definition at line 258 of file string.inl.

compare() [1/6]

template<class char_t , class traits_t >

int qx::basic_string< char_t, traits_t >::compare ( const basic_string< char_t, traits_t > &  sStr ) const

inlinenoexcept

Performs a binary comparison of the characters.

Parameters

sStr	- string to compare

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1263 of file string.inl.

compare() [2/6]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

int qx::basic_string< char_t, traits_t >::compare ( const string_t &  sStr ) const

inlinenoexcept

Performs a binary comparison of the characters.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to compare

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1277 of file string.inl.

compare() [3/6]

template<class char_t , class traits_t >

int qx::basic_string< char_t, traits_t >::compare ( const_pointer  pStr, size_type  nStrSize  ) const

inlinenoexcept

Performs a binary comparison of the characters.

Parameters

pStr	- string to compare. must not be nullptr
nStrSize	- number of symbols to compare

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1257 of file string.inl.

compare() [4/6]

template<class char_t , class traits_t >

int qx::basic_string< char_t, traits_t >::compare ( const_pointer  pszStr ) const

inlinenoexcept

Performs a binary comparison of the characters.

Parameters

pszStr

- string to compare. must not be nullptr

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1251 of file string.inl.

compare() [5/6]

template<class char_t , class traits_t >

template<class fwd_it_t >

int qx::basic_string< char_t, traits_t >::compare ( fwd_it_t  itBegin, fwd_it_t  itEnd  ) const

inlinenoexcept

Performs a binary comparison of the characters.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string to compare begin iterator
itEnd	- string to compare end iterator

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1270 of file string.inl.

compare() [6/6]

template<class char_t , class traits_t >

int qx::basic_string< char_t, traits_t >::compare ( value_type  chSymbol ) const

inlinenoexcept

Performs a binary comparison of the characters.

Parameters

chSymbol

- symbol to compare

Return values

-	< 0 the first character that does not match has a lower value in this than in chSymbol = 0 the contents of both strings are equal > 0 the first character that does not match has a greater value in this than in chSymbol

Definition at line 1245 of file string.inl.

contains() [1/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::contains ( const basic_string< char_t, traits_t > &  sStr ) const

inlinenoexcept

Check if string contains substring.

Equal to find != npos

Parameters

sStr	- string to check

Return values

-	true if this string contains substring

Definition at line 1999 of file string.inl.

contains() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

bool qx::basic_string< char_t, traits_t >::contains ( const string_t &  sStr ) const

inlinenoexcept

Check if string contains substring.

Equal to find != npos

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to check

Return values

-	true if this string contains substring

Definition at line 2013 of file string.inl.

contains() [3/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::contains ( const_pointer  pszStr, size_type  nStrSize = npos  ) const

inlinenoexcept

Check if string contains substring.

Equal to find != npos

Parameters

pszStr	- substring to check
nStrSize	- substring size

Return values

-	true if this string contains substring

Definition at line 1993 of file string.inl.

contains() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

bool qx::basic_string< char_t, traits_t >::contains ( fwd_it_t  itBegin, fwd_it_t  itEnd  ) const

inlinenoexcept

Check if string contains substring.

Equal to find != npos

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- substring begin iterator
itEnd	- substring end iterator

Return values

-	true if this string contains substring

Definition at line 2006 of file string.inl.

contains() [5/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::contains ( value_type  chSymbol ) const

inlinenoexcept

Check if string contains char.

Equal to find != npos

Parameters

chSymbol

- char to check

Return values

-	true if this string contains substring

Definition at line 1987 of file string.inl.

copy()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::copy ( pointer  pDest, size_type  nCount, size_type  nPos = 0  ) const

inlinenoexcept

Copies a substring [nPos, nPos + nCount) to character string pointed to by pDest.

Parameters

pDest	- pointer to the destination character string
nCount	- length of the substring
nPos	- position of the first character to include

Return values

-	number of characters copied

Definition at line 319 of file string.inl.

ends_with() [1/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::ends_with ( const basic_string< char_t, traits_t > &  sStr ) const

inlinenoexcept

Check if current string ends with string.

Parameters

sStr	- string to check

Return values

-	true if starts with string

Definition at line 1967 of file string.inl.

ends_with() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

bool qx::basic_string< char_t, traits_t >::ends_with ( const string_t &  sStr ) const

inlinenoexcept

Check if current string ends with string.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string container to check

Return values

-	true if starts with string

Definition at line 1981 of file string.inl.

ends_with() [3/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::ends_with ( const_pointer  pszStr, size_type  nStrSize = npos  ) const

inlinenoexcept

Check if current string ends with string.

Parameters

pszStr	- const pointer to string
nStrSize	- string length

Return values

-	true if ends with string

Definition at line 1949 of file string.inl.

ends_with() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

bool qx::basic_string< char_t, traits_t >::ends_with ( fwd_it_t  itBegin, fwd_it_t  itEnd  ) const

inlinenoexcept

Check if current string ends with string.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string begin iterator
itEnd	- string end iterator

Return values

-	true if ends with string

Definition at line 1974 of file string.inl.

ends_with() [5/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::ends_with ( value_type  chSymbol ) const

inlinenoexcept

Check if current string ends with char.

Parameters

chSymbol

- char for comparison

Return values

-	true if ends with char

Definition at line 1939 of file string.inl.

erase() [1/4]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::erase ( iterator  itFirst, iterator  itLast  )

inlinenoexcept

Erase substring.

Parameters

itFirst	- first substr char iterator
itLast	- last substr char iterator (excluded)

Definition at line 557 of file string.inl.

erase() [2/4]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::erase ( iterator  itPos )

inlinenoexcept

Erase on iterator.

Parameters

itPos

- iterator where to erase

Definition at line 577 of file string.inl.

erase() [3/4]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::erase ( size_type  nPos )

inlinenoexcept

Erase on position.

Parameters

nPos	- index where to erase

Definition at line 583 of file string.inl.

erase() [4/4]

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::erase ( size_type  nPos, size_type  nSymbols  )

inlinenoexcept

Erase substring.

Parameters

nPos	- start position
nSymbols	- number of symbols

Definition at line 589 of file string.inl.

find() [1/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find ( const basic_string< char_t, traits_t > &  sWhat, size_type  nBegin = 0, size_type  nEnd = npos  ) const

inlinenoexcept

Find substring.

Parameters

sWhat	- string to find
nBegin	- start searching index
nEnd	- end searching index

Return values

-	substring index or npos if not found

Definition at line 1323 of file string.inl.

find() [2/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find ( const_pointer  pszWhat, size_type  nBegin = 0, size_type  nWhatSize = npos, size_type  nEnd = npos  ) const

inlinenoexcept

Find substring.

Parameters

pszWhat	- string to find
nBegin	- start searching index
nWhatSize	- string length (npos - string is zero terminated)
nEnd	- end searching index (npos - to the end).

Return values

-	substring index

Definition at line 1298 of file string.inl.

find() [3/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nBegin = 0, size_type  nEnd = npos  ) const

inlinenoexcept

Find substring.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- substring begin iterator
itWhatEnd	- substring end iterator
nBegin	- start searching index
nEnd	- end searching index

Return values

-	substring index or npos if not found

Definition at line 1333 of file string.inl.

find() [4/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find ( string_t  sWhat, size_type  nBegin = 0, size_type  nEnd = npos  ) const

inlinenoexcept

Find substring.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- substring
nBegin	- start searching index
nEnd	- end searching index

Return values

-	substring index or npos if not found

Definition at line 1354 of file string.inl.

find() [5/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find ( value_type  chSymbol, size_type  nBegin = 0, size_type  nEnd = npos  ) const

inlinenoexcept

Find substring.

Parameters

chSymbol	- char to find
nBegin	- start searching index
nEnd	- end searching index (npos - to the end)

Return values

-	substring index or npos if not found

Definition at line 1283 of file string.inl.

find_first_not_of() [1/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( const basic_string< char_t, traits_t > &  sWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to none of the characters in the given character sequence.

Parameters

sWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1676 of file string.inl.

find_first_not_of() [2/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( const_pointer  pszWhat, size_type  nBegin, size_type  nWhatSize  ) const

inlinenoexcept

Finds the first character equal to none of the characters in the given character sequence.

Parameters

pszWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin
nWhatSize	- length of character string identifying characters to search for

Return values

-	symbol index or npos

Definition at line 1631 of file string.inl.

find_first_not_of() [3/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( const_pointer  pszWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to none of the characters in the given character sequence.

Parameters

pszWhat	- null terminated string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1654 of file string.inl.

find_first_not_of() [4/6]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to none of the characters in the given character sequence.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- begin it of string identifying characters to search for
itWhatEnd	- end it of string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1685 of file string.inl.

find_first_not_of() [5/6]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( string_t  sWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to none of the characters in the given character sequence.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1702 of file string.inl.

find_first_not_of() [6/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_not_of ( value_type  chSymbol, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character not equal to chSymbol.

Parameters

chSymbol	- char to find
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1617 of file string.inl.

find_first_of() [1/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( const basic_string< char_t, traits_t > &  sWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to one of characters in the given character sequence.

Parameters

sWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1496 of file string.inl.

find_first_of() [2/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( const_pointer  pszWhat, size_type  nBegin, size_type  nWhatSize  ) const

inlinenoexcept

Finds the first character equal to one of characters in the given character sequence.

Parameters

pszWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin
nWhatSize	- length of character string identifying characters to search for

Return values

-	symbol index or npos

Definition at line 1451 of file string.inl.

find_first_of() [3/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( const_pointer  pszWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to one of characters in the given character sequence.

Parameters

pszWhat	- null terminated string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1474 of file string.inl.

find_first_of() [4/6]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to one of characters in the given character sequence.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- begin it of string identifying characters to search for
itWhatEnd	- end it of string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1505 of file string.inl.

find_first_of() [5/6]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( string_t  sWhat, size_type  nBegin = 0  ) const

inlinenoexcept

Finds the first character equal to one of characters in the given character sequence.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- string identifying characters to search for
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1522 of file string.inl.

find_first_of() [6/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_first_of ( value_type  chSymbol, size_type  nBegin = 0  ) const

inlinenoexcept

Find first position of character.

Parameters

chSymbol	- char to find
nBegin	- position at which the search is to begin

Return values

-	symbol index or npos

Definition at line 1443 of file string.inl.

find_last_not_of() [1/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( const basic_string< char_t, traits_t > &  sWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to none of the characters in the given character sequence.

Parameters

sWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1769 of file string.inl.

find_last_not_of() [2/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( const_pointer  pszWhat, size_type  nEnd, size_type  nWhatSize  ) const

inlinenoexcept

Finds the last character equal to none of the characters in the given character sequence.

Parameters

pszWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish
nWhatSize	- length of character string identifying characters to search for

Return values

-	symbol index or npos

Definition at line 1724 of file string.inl.

find_last_not_of() [3/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( const_pointer  pszWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to none of the characters in the given character sequence.

Parameters

pszWhat	- null terminated string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1747 of file string.inl.

find_last_not_of() [4/6]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to none of the characters in the given character sequence.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- begin it of string identifying characters to search for
itWhatEnd	- end it of string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1778 of file string.inl.

find_last_not_of() [5/6]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( string_t  sWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to none of the characters in the given character sequence.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1795 of file string.inl.

find_last_not_of() [6/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_not_of ( value_type  chSymbol, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character not equal to chSymbol.

Parameters

chSymbol	- char to find
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1710 of file string.inl.

find_last_of() [1/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( const basic_string< char_t, traits_t > &  sWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to one of characters in the given character sequence.

Parameters

sWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1583 of file string.inl.

find_last_of() [2/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( const_pointer  pszWhat, size_type  nEnd, size_type  nWhatSize  ) const

inlinenoexcept

Finds the last character equal to one of characters in the given character sequence.

Parameters

pszWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish
nWhatSize	- length of character string identifying characters to search for

Return values

-	symbol index or npos

Definition at line 1538 of file string.inl.

find_last_of() [3/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( const_pointer  pszWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to one of characters in the given character sequence.

Parameters

pszWhat	- null terminated string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1561 of file string.inl.

find_last_of() [4/6]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to one of characters in the given character sequence.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- begin it of string identifying characters to search for
itWhatEnd	- end it of string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1592 of file string.inl.

find_last_of() [5/6]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( string_t  sWhat, size_type  nEnd = 0  ) const

inlinenoexcept

Finds the last character equal to one of characters in the given character sequence.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- string identifying characters to search for
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1609 of file string.inl.

find_last_of() [6/6]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::find_last_of ( value_type  chSymbol, size_type  nEnd = 0  ) const

inlinenoexcept

Find last position of character.

Parameters

chSymbol	- char to find
nEnd	- position at which the search is to finish

Return values

-	symbol index or npos

Definition at line 1530 of file string.inl.

format()

template<class char_t , class traits_t >

template<class... args_t>

requires format_acceptable_args< char_t, args_t... > void qx::basic_string< char_t, traits_t >::format	(	const format_string_type< std::type_identity_t< args_t >... >	sFormat,
		args_t &&...	args
	)

Clear the string and format it with the format string and the args.

Format string will be checked at compile time

Template Parameters

args_t

- template parameter pack type

Parameters

sFormat	- format string
args	- format arguments

Definition at line 125 of file string.inl.

from()

template<class char_t , class traits_t >

template<class from_t >

void qx::basic_string< char_t, traits_t >::from ( const from_t &  data )

inline

Construct string from custom type.

Template Parameters

from_t

- type to convert from

Parameters

data	- data of type from_type

Definition at line 337 of file string.inl.

front()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::value_type qx::basic_string< char_t, traits_t >::front

inlinenoexcept

Get first char of the string.

Return values

-	first char of the string

Definition at line 234 of file string.inl.

insert() [1/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( const_iterator  itPos, const basic_string< char_t, traits_t > &  sWhat  )

inlinenoexcept

Insert substring.

Parameters

itPos	- first char iterator
sWhat	- string to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 518 of file string.inl.

insert() [2/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( const_iterator  itPos, const_pointer  pszWhat, size_type  nSymbols = npos  )

inlinenoexcept

Insert substring.

Parameters

itPos	- first char iterator
pszWhat	- source string
nSymbols	- number of symbols to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 509 of file string.inl.

insert() [3/10]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( const_iterator  itPos, fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd  )

inlinenoexcept

Insert substring.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itPos	- first char iterator
itWhatBegin	- source string first iterator
itWhatEnd	- source string last iterator

Return values

-	pos of char after last char of inserted string or npos

Definition at line 527 of file string.inl.

insert() [4/10]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( const_iterator  itPos, string_t  sWhat  )

inlinenoexcept

Insert substring.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

itPos	- first char iterator
sWhat	- source string

Return values

-	pos of char after last char of inserted string or npos

Definition at line 537 of file string.inl.

insert() [5/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( const_iterator  itPos, value_type  chSymbol  )

inlinenoexcept

Insert char.

Parameters

itPos	- first char iterator
chSymbol	- char to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 501 of file string.inl.

insert() [6/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( size_type  nPos, const basic_string< char_t, traits_t > &  sWhat  )

inlinenoexcept

Insert substring.

Parameters

nPos	- first char index
sWhat	- string to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 484 of file string.inl.

insert() [7/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( size_type  nPos, const_pointer  pszWhat, size_type  nSymbols = npos  )

inlinenoexcept

Insert substring.

Parameters

nPos	- first char index
pszWhat	- source string
nSymbols	- number of symbols to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 424 of file string.inl.

insert() [8/10]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( size_type  nPos, fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd  )

inlinenoexcept

Insert substring.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

nPos	- first char index
itWhatBegin	- source first iterator
itWhatEnd	- source last iterator

Return values

-	pos of char after last char of inserted string or npos

Definition at line 447 of file string.inl.

insert() [9/10]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( size_type  nPos, string_t  sWhat  )

inlinenoexcept

Insert substring.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

nPos	- first char index
sWhat	- source string

Return values

-	pos of char after last char of inserted string or npos

Definition at line 493 of file string.inl.

insert() [10/10]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::insert ( size_type  nPos, value_type  chSymbol  )

inlinenoexcept

Insert substring.

Parameters

nPos	- first char index
chSymbol	- symbol to insert

Return values

-	pos of char after last char of inserted string or npos

Definition at line 416 of file string.inl.

length()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::length

inlinenoexcept

Get string length.

Same as size()

Return values

-	string length

Definition at line 246 of file string.inl.

max_size()

template<class char_t , class traits_t >

constexpr basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::max_size

staticconstexprnoexcept

Get the theoretical maximum of string size.

Return values

-	theoretical maximum of string size

Definition at line 264 of file string.inl.

pop_back()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::value_type qx::basic_string< char_t, traits_t >::pop_back

inlinenoexcept

Erase last char and return it.

Return values

-

last char

Definition at line 595 of file string.inl.

pop_front()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::value_type qx::basic_string< char_t, traits_t >::pop_front

inlinenoexcept

Erase first char and return it.

Return values

-	first char

Definition at line 603 of file string.inl.

push_back()

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::push_back ( value_type  chSymbol )

inlinenoexcept

Insert char in the end of the string.

Parameters

chSymbol

- char to insert

Definition at line 545 of file string.inl.

push_front()

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::push_front ( value_type  chSymbol )

inlinenoexcept

Insert char in the beginning of the string.

Parameters

chSymbol

- char to insert

Definition at line 551 of file string.inl.

remove() [1/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove ( const basic_string< char_t, traits_t > &  sStr, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove the first occurrence of a substring in a string.

Parameters

sStr	- string to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	position where the first occurrence was or npos

Definition at line 948 of file string.inl.

remove() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove ( const string_t &  sStr, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove the first occurrence of a substring in a string.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	position where the first occurrence was or npos

Definition at line 979 of file string.inl.

remove() [3/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove ( const_pointer  pszStr, size_type  nBegin = 0, size_type  nEnd = npos, size_type  nStrSize = npos  )

inlinenoexcept

Remove the first occurrence of a substring in a string.

Parameters

pszStr	- c-string to remove
nBegin	- start searching index
nEnd	- end searching index
nStrSize	- c-string size

Return values

-	position where the first occurrence was or npos

Definition at line 925 of file string.inl.

remove() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove ( fwd_it_t  itBegin, fwd_it_t  itEnd, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove the first occurrence of a substring in a string.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string begin iterator
itEnd	- string end iterator
nBegin	- start searching index
nEnd	- end searching index

Return values

-	position where the first occurrence was or npos

Definition at line 963 of file string.inl.

remove() [5/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove ( value_type  chSymbol, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove the first occurrence of a substring in a string.

Parameters

chSymbol	- char to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	position where the first occurrence was or npos

Definition at line 911 of file string.inl.

remove_all() [1/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove_all ( const basic_string< char_t, traits_t > &  sStr, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove all occurrences of a substring in a string.

Parameters

sStr	- string to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	number of deleted occurrences

Definition at line 1109 of file string.inl.

remove_all() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove_all ( const string_t &  sStr, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove all occurrences of a substring in a string.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	number of deleted occurrences

Definition at line 1139 of file string.inl.

remove_all() [3/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove_all ( const_pointer  pszStr, size_type  nBegin = 0, size_type  nEnd = npos, size_type  nStrSize = npos  )

inlinenoexcept

Remove all occurrences of a substring in a string.

Parameters

pszStr	- string to remove
nBegin	- start searching index
nEnd	- end searching index
nStrSize	- string size

Return values

-	number of deleted occurrences

Definition at line 1083 of file string.inl.

remove_all() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove_all ( fwd_it_t  itFirst, fwd_it_t  itLast, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove all occurrences of a substring in a string.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itFirst	- string begin iterator
itLast	- string end iterator
nBegin	- start searching index
nEnd	- end searching index

Return values

-	number of deleted occurrences

Definition at line 1119 of file string.inl.

remove_all() [5/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::remove_all ( value_type  chSymbol, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Remove all occurrences of a substring in a string.

Parameters

chSymbol	- char to remove
nBegin	- start searching index
nEnd	- end searching index

Return values

-	number of deleted occurrences

Definition at line 1065 of file string.inl.

remove_prefix() [1/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_prefix ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Remove string prefix if matches.

Parameters

sStr	- string to remove

Return values

-	true if removed

Definition at line 1000 of file string.inl.

remove_prefix() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

bool qx::basic_string< char_t, traits_t >::remove_prefix ( const string_t &  sStr )

inlinenoexcept

Remove string prefix if matches.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to remove

Return values

-	true if removed

Definition at line 1015 of file string.inl.

remove_prefix() [3/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_prefix ( const_pointer  pszStr, size_type  nStrSize = npos  )

inlinenoexcept

Remove string prefix if matches.

Parameters

pszStr	- string to remove
nStrSize	- string size

Return values

-	true if removed

Definition at line 994 of file string.inl.

remove_prefix() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

bool qx::basic_string< char_t, traits_t >::remove_prefix ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Remove string prefix if matches.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string to remove begin iterator
itEnd	- string to remove end iterator

Return values

-	true if removed

Definition at line 1007 of file string.inl.

remove_prefix() [5/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_prefix ( value_type  chSymbol )

inlinenoexcept

Remove string prefix if matches.

Parameters

chSymbol

- char to remove

Return values

-	true if removed

Definition at line 988 of file string.inl.

remove_suffix() [1/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_suffix ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Remove string suffix if matches.

Parameters

sStr	- string to remove

Return values

-	true if removed

Definition at line 1044 of file string.inl.

remove_suffix() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

bool qx::basic_string< char_t, traits_t >::remove_suffix ( const string_t &  sStr )

inlinenoexcept

Remove string suffix if matches.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string to remove

Return values

-	true if removed

Definition at line 1059 of file string.inl.

remove_suffix() [3/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_suffix ( const_pointer  pszStr, size_type  nStrSize = npos  )

inlinenoexcept

Remove string suffix if matches.

Parameters

pszStr	- string to remove
nStrSize	- string size

Return values

-	true if removed

Definition at line 1028 of file string.inl.

remove_suffix() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

bool qx::basic_string< char_t, traits_t >::remove_suffix ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Remove string suffix if matches.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string to remove begin iterator
itEnd	- string to remove end iterator

Return values

-	true if removed

Definition at line 1051 of file string.inl.

remove_suffix() [5/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::remove_suffix ( value_type  chSymbol )

inlinenoexcept

Remove string suffix if matches.

Parameters

chSymbol

- char to remove

Return values

-	true if removed

Definition at line 1021 of file string.inl.

replace()

template<class char_t , class traits_t >

template<class find_string_t , class replace_string_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::replace ( const find_string_t &  sFind, const replace_string_t &  sReplace, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Replace first occurrence of sFind with sReplace.

Template Parameters

find_string_t	- find string type
replace_string_t	- replace string type

Parameters

sFind	- string to find and replace
sReplace	- string to replace with
nBegin	- start searching index
nEnd	- end searching index

Return values

-	pos of char after last char of replaced string or npos

Definition at line 1149 of file string.inl.

replace_all()

template<class char_t , class traits_t >

template<class find_string_t , class replace_string_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::replace_all ( const find_string_t &  sFind, const replace_string_t &  sReplace, size_type  nBegin = 0, size_type  nEnd = npos  )

inlinenoexcept

Replace all occurrences of sFind with sReplace.

Template Parameters

find_string_t	- find string type
replace_string_t	- replace string type

Parameters

sFind	- string to find and replace
sReplace	- string to replace with
nBegin	- start searching index
nEnd	- end searching index

Return values

-	number of replaced occurrences

Definition at line 1225 of file string.inl.

reserve()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::reserve ( size_type  nCapacity )

inlinenoexcept

Reserve memory for the string.

Parameters

nCapacity

- required capacity

Return values

-	new string capacity

Definition at line 189 of file string.inl.

rfind() [1/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::rfind ( const basic_string< char_t, traits_t > &  sWhat, size_type  nBegin = npos, size_type  nEnd = 0  ) const

inlinenoexcept

Find substring (reverse direction)

Parameters

sWhat	- string to find
nBegin	- start searching index
nEnd	- end searching index (if nBegin < end, result is equivalent of find(...))

Return values

-	substring index or npos if not found

Definition at line 1403 of file string.inl.

rfind() [2/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::rfind ( const_pointer  pszWhat, size_type  nBegin = npos, size_type  nWhatSize = npos, size_type  nEnd = 0  ) const

inlinenoexcept

Find substring (reverse direction)

Parameters

pszWhat	- c-string to find
nBegin	- start searching index
nWhatSize	- c-string length
nEnd	- end searching index (if nBegin < end, result is equivalent of find(...))

Return values

-	substring index or npos if not found

Definition at line 1378 of file string.inl.

rfind() [3/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::rfind ( fwd_it_t  itWhatBegin, fwd_it_t  itWhatEnd, size_type  nBegin = npos, size_type  nEnd = 0  ) const

inlinenoexcept

Find substring (reverse direction)

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itWhatBegin	- substring begin iterator
itWhatEnd	- substring end iterator
nBegin	- start searching index
nEnd	- end searching index (if nBegin < end, result is equivalent of find(...))

Return values

-	substring index or npos if not found

Definition at line 1413 of file string.inl.

rfind() [4/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::rfind ( string_t  sWhat, size_type  nBegin = npos, size_type  nEnd = 0  ) const

inlinenoexcept

Find substring (reverse direction)

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sWhat	- substring
nBegin	- start searching index
nEnd	- end searching index (if nBegin < end, result is equivalent of find(...))

Return values

-	substring index or npos if not found

Definition at line 1434 of file string.inl.

rfind() [5/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::rfind ( value_type  chSymbol, size_type  nBegin = npos, size_type  nEnd = 0  ) const

inlinenoexcept

Find substring (reverse direction)

Parameters

chSymbol	- char to find
nBegin	- start searching index
nEnd	- end searching index (if nBegin < end, result is equivalent of find(...))

Return values

-	substring index or npos if not found

Definition at line 1363 of file string.inl.

split() [1/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::views qx::basic_string< char_t, traits_t >::split ( const basic_string< char_t, traits_t > &  sSeparator ) const

inlinenoexcept

Split string by separator.

Parameters

sSeparator

- separator string

Return values

-	string_view container

Definition at line 1854 of file string.inl.

split() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::views qx::basic_string< char_t, traits_t >::split ( const string_t &  sSeparator ) const

inlinenoexcept

Split string by separator.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sSeparator

- separator string

Return values

-	string_view container

Definition at line 1884 of file string.inl.

split() [3/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::views qx::basic_string< char_t, traits_t >::split ( const value_type  chSeparator ) const

inlinenoexcept

Split string by separator.

Parameters

chSeparator

- char separator

Return values

-	string_view container

Definition at line 1803 of file string.inl.

split() [4/5]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::views qx::basic_string< char_t, traits_t >::split ( const_pointer  pszSeparator, size_type  nSepLen = npos  ) const

inlinenoexcept

Split string by separator.

Parameters

pszSeparator	- separator string
nSepLen	- separator string length (npos if str is null terminated)

Return values

-	string_view container

Definition at line 1825 of file string.inl.

split() [5/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::views qx::basic_string< char_t, traits_t >::split ( fwd_it_t  itSepFirst, fwd_it_t  itSepLast  ) const

inlinenoexcept

Split string by separator.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itSepFirst	- separator begin iterator
itSepLast	- separator end iterator

Return values

-	string_view container

Definition at line 1862 of file string.inl.

starts_with() [1/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::starts_with ( const basic_string< char_t, traits_t > &  sStr ) const

inlinenoexcept

Check if current string starts with string.

Parameters

sStr	- string to check

Return values

-	true if starts with string

Definition at line 1918 of file string.inl.

starts_with() [2/5]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

bool qx::basic_string< char_t, traits_t >::starts_with ( const string_t &  sStr ) const

inlinenoexcept

Check if current string starts with string.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string container to check

Return values

-	true if starts with string

Definition at line 1933 of file string.inl.

starts_with() [3/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::starts_with ( const_pointer  pszStr, size_type  nStrSize = npos  ) const

inlinenoexcept

Check if current string starts with string.

Parameters

pszStr	- const pointer to string
nStrSize	- string length

Return values

-	true if starts with string

Definition at line 1900 of file string.inl.

starts_with() [4/5]

template<class char_t , class traits_t >

template<class fwd_it_t >

bool qx::basic_string< char_t, traits_t >::starts_with ( fwd_it_t  itBegin, fwd_it_t  itEnd  ) const

inlinenoexcept

Check if current string starts with string.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- string begin iterator
itEnd	- string end iterator

Return values

-	true if starts with string

Definition at line 1925 of file string.inl.

starts_with() [5/5]

template<class char_t , class traits_t >

bool qx::basic_string< char_t, traits_t >::starts_with ( value_type  chSymbol ) const

inlinenoexcept

Check if current string starts with char.

Parameters

chSymbol

- char for comparison

Return values

-	true if starts with char

Definition at line 1891 of file string.inl.

static_format()

template<class char_t , class traits_t >

template<class... args_t>

requires static format_acceptable_args<char_t, args_t...> basic_string qx::basic_string< char_t, traits_t >::static_format ( const format_string_type< std::type_identity_t< args_t >... >  sFormat, args_t &&...  args  )

static

Create a string by formatting it with the format string and the args.

Format string will be checked at compile time

Template Parameters

args_t

- template parameter pack type

Parameters

sFormat	- format string
args	- format arguments

Return values

-	formatted string

static_from()

template<class char_t , class traits_t >

template<class from_t >

static basic_string qx::basic_string< char_t, traits_t >::static_from ( const from_t &  data )

static

Construct string from custom type and get it.

Template Parameters

from_t

- type to convert from

Parameters

data	- data of type from_type

Return values

-	constructed string

static_vformat()

template<class char_t , class traits_t >

template<class... args_t>

requires static format_acceptable_args<char_t, args_t...> basic_string qx::basic_string< char_t, traits_t >::static_vformat ( string_view  svFormat, args_t &&...  args  )

static

Create a string by formatting it with the format string and the args.

No compile time checks, method will throw is something is wrong with the format string

Template Parameters

args_t

- template parameter pack type

Parameters

svFormat	- format string
args	- format arguments

Return values

-	formatted string

substr()

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::string_view qx::basic_string< char_t, traits_t >::substr ( size_type  nPos, size_type  nSymbols = npos  ) const

inlinenoexcept

Get substring.

Parameters

nPos	- start index
nSymbols	- string size (npos - to the end)

Return values

-	substring view

Definition at line 212 of file string.inl.

swap()

template<class char_t , class traits_t >

void qx::basic_string< char_t, traits_t >::swap ( basic_string< char_t, traits_t > &  sOther )

inlinenoexcept

Swap this str and other.

Parameters

sOther

- other str

Definition at line 183 of file string.inl.

to()

template<class char_t , class traits_t >

template<class to_t >

std::optional< to_t > qx::basic_string< char_t, traits_t >::to ( const_pointer  pszFormat = nullptr ) const

inlinenoexcept

Convert string to specified type.

Warning

This function currently uses unsafe scanf functions from the c library, since the current implementation of the standard library does not have an implementation of fmt::scan (https://github.com/fmtlib/fmt/blob/master/test/scan.h). Status: https://github.com/cplusplus/papers/issues/493 This will be fixed in the future when possible.

Template Parameters

to_t	- type to convert

Parameters

pszFormat

- format string (according to https://en.cppreference.com/w/c/io/fscanf)

Return values

-	converted value or std::nullopt

Definition at line 272 of file string.inl.

trim() [1/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim

inlinenoexcept

Trim the string to the both sides (whitespace characters)

Return values

-	number of deleted symbols

Definition at line 811 of file string.inl.

trim() [2/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Trim the string to the both sides.

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 879 of file string.inl.

trim() [3/7]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( const string_t &  sStr )

inlinenoexcept

Trim the string to the both sides.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 904 of file string.inl.

trim() [4/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( const_pointer  pszStr )

inlinenoexcept

Trim the string to the both sides.

Parameters

pszStr

- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 832 of file string.inl.

trim() [5/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( const_pointer  pszStr, size_type  nStrSize  )

inlinenoexcept

Trim the string to the both sides.

Parameters

pszStr	- string with symbols to delete
nStrSize	- string size

Return values

-	number of deleted symbols

Definition at line 856 of file string.inl.

trim() [6/7]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Trim the string to the both sides.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- begin it of string with symbols to delete
itEnd	- begin it of string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 887 of file string.inl.

trim() [7/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim ( value_type  chSymbol )

inlinenoexcept

Trim the string to the both sides.

Parameters

chSymbol

- symbol to delete

Return values

-	number of deleted symbols

Definition at line 821 of file string.inl.

trim_left() [1/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left

inlinenoexcept

Trim the string to the left (whitespace characters)

Return values

-	number of deleted symbols

Definition at line 611 of file string.inl.

trim_left() [2/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Trim the string to the left.

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 679 of file string.inl.

trim_left() [3/7]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( const string_t &  sStr )

inlinenoexcept

Trim the string to the left.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 704 of file string.inl.

trim_left() [4/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( const_pointer  pszStr )

inlinenoexcept

Trim the string to the left.

Parameters

pszStr

- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 632 of file string.inl.

trim_left() [5/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( const_pointer  pszStr, size_type  nStrSize  )

inlinenoexcept

Trim the string to the left.

Parameters

pszStr	- string with symbols to delete
nStrSize	- string size

Return values

-	number of deleted symbols

Definition at line 656 of file string.inl.

trim_left() [6/7]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Trim the string to the left.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- begin it of string with symbols to delete
itEnd	- begin it of string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 687 of file string.inl.

trim_left() [7/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_left ( value_type  chSymbol )

inlinenoexcept

Trim the string to the left.

Parameters

chSymbol

- symbol to delete

Return values

-	number of deleted symbols

Definition at line 621 of file string.inl.

trim_right() [1/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right

inlinenoexcept

Trim the string to the right (whitespace characters)

Return values

-	number of deleted symbols

Definition at line 711 of file string.inl.

trim_right() [2/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( const basic_string< char_t, traits_t > &  sStr )

inlinenoexcept

Trim the string to the right.

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 779 of file string.inl.

trim_right() [3/7]

template<class char_t , class traits_t >

template<range_of_t_c< char_t > string_t>

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( const string_t &  sStr )

inlinenoexcept

Trim the string to the right.

Template Parameters

string_t

- string-ish type, satisfying the "range_of_t_c" concept

Parameters

sStr	- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 804 of file string.inl.

trim_right() [4/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( const_pointer  pszStr )

inlinenoexcept

Trim the string to the right.

Parameters

pszStr

- string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 732 of file string.inl.

trim_right() [5/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( const_pointer  pszStr, size_type  nStrSize  )

inlinenoexcept

Trim the string to the right.

Parameters

pszStr	- string with symbols to delete
nStrSize	- string size

Return values

-	number of deleted symbols

Definition at line 756 of file string.inl.

trim_right() [6/7]

template<class char_t , class traits_t >

template<class fwd_it_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( fwd_it_t  itBegin, fwd_it_t  itEnd  )

inlinenoexcept

Trim the string to the right.

Template Parameters

fwd_it_t

- forward iterator type

Parameters

itBegin	- begin it of string with symbols to delete
itEnd	- begin it of string with symbols to delete

Return values

-	number of deleted symbols

Definition at line 787 of file string.inl.

trim_right() [7/7]

template<class char_t , class traits_t >

basic_string< char_t, traits_t >::size_type qx::basic_string< char_t, traits_t >::trim_right ( value_type  chSymbol )

inlinenoexcept

Trim the string to the right.

Parameters

chSymbol

- symbol to delete

Return values

-	number of deleted symbols

Definition at line 721 of file string.inl.

vformat()

template<class char_t , class traits_t >

template<class... args_t>

requires format_acceptable_args< char_t, args_t... > void qx::basic_string< char_t, traits_t >::vformat	(	string_view	svFormat,
		args_t &&...	args
	)

Clear the string and format it with the format string and the args.

No compile time checks, method will throw is something is wrong with the format string

Template Parameters

args_t

- template parameter pack type

Parameters

svFormat	- format string
args	- format arguments

Definition at line 155 of file string.inl.

---

The documentation for this class was generated from the following files:

• include/qx/containers/string/string.h
• include/qx/containers/string/string.inl