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 (format_string_type< args_t... > sFormat, const 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 (format_string_type< args_t... > sFormat, const 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, const 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, const 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 (format_string_type< args_t... > sFormat, const 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, const 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 391 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 406 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 378 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 398 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 372 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	(	format_string_type< args_t... >	sFormat,
		const 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 143 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,
		const 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 172 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 236 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 248 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 254 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 1259 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 1273 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 1253 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 1247 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 1266 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 1241 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 1995 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 2009 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 1989 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 2002 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 1983 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 315 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 1963 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 1977 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 1945 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 1970 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 1935 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 553 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 573 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 579 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 585 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 1319 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 1294 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 1329 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 1350 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 1279 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 1672 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 1627 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 1650 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 1681 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 1698 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 1613 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 1492 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 1447 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 1470 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 1501 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 1518 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 1439 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 1765 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 1720 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 1743 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 1774 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 1791 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 1706 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 1579 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 1534 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 1557 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 1588 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 1605 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 1526 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	(	format_string_type< args_t... >	sFormat,
		const 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 333 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 230 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 514 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 505 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 523 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 533 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 497 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 480 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 420 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 443 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 489 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 412 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 242 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 260 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 591 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 599 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 541 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 547 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 944 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 975 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 921 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 959 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 907 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 1105 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 1135 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 1079 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 1115 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 1061 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 996 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 1011 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 990 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 1003 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 984 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 1040 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 1055 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 1024 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 1047 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 1017 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 1145 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 1221 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 185 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 1399 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 1374 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 1409 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 1430 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 1359 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 1850 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 1880 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 1799 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 1821 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 1858 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 1914 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 1929 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 1896 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 1921 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 1887 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	(	format_string_type< args_t... >	sFormat,
		const 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,
		const 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 208 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 179 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 268 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 807 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 875 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 900 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 828 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 852 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 883 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 817 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 607 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 675 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 700 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 628 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 652 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 683 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 617 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 707 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 775 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 800 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 728 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 752 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 783 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 717 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,
		const 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 151 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

Public Member Functions

Static Public Member Functions

Detailed Description

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

Constructor & Destructor Documentation

◆ basic_string() [1/7]

◆ basic_string() [2/7]

◆ basic_string() [3/7]

◆ basic_string() [4/7]

◆ basic_string() [5/7]

◆ basic_string() [6/7]

◆ basic_string() [7/7]

Member Function Documentation

◆ append() [1/5]

◆ append() [2/5]

◆ append() [3/5]

◆ append() [4/5]

◆ append() [5/5]

◆ append_format()

◆ append_vformat()

◆ assign() [1/7]

◆ assign() [2/7]

◆ assign() [3/7]

◆ assign() [4/7]

◆ assign() [5/7]

◆ assign() [6/7]

◆ assign() [7/7]

◆ back()

◆ c_str()

◆ capacity()

◆ compare() [1/6]

◆ compare() [2/6]

◆ compare() [3/6]

◆ compare() [4/6]

◆ compare() [5/6]

◆ compare() [6/6]

◆ contains() [1/5]

◆ contains() [2/5]

◆ contains() [3/5]

◆ contains() [4/5]

◆ contains() [5/5]

◆ copy()

◆ ends_with() [1/5]

◆ ends_with() [2/5]

◆ ends_with() [3/5]

◆ ends_with() [4/5]

◆ ends_with() [5/5]

◆ erase() [1/4]

◆ erase() [2/4]

◆ erase() [3/4]

◆ erase() [4/4]

◆ find() [1/5]

◆ find() [2/5]

◆ find() [3/5]

◆ find() [4/5]

◆ find() [5/5]

◆ find_first_not_of() [1/6]

◆ find_first_not_of() [2/6]

◆ find_first_not_of() [3/6]

◆ find_first_not_of() [4/6]

◆ find_first_not_of() [5/6]

◆ find_first_not_of() [6/6]

◆ find_first_of() [1/6]

◆ find_first_of() [2/6]

◆ find_first_of() [3/6]

◆ find_first_of() [4/6]

◆ find_first_of() [5/6]

◆ find_first_of() [6/6]

◆ find_last_not_of() [1/6]

◆ find_last_not_of() [2/6]

◆ find_last_not_of() [3/6]

◆ find_last_not_of() [4/6]

◆ find_last_not_of() [5/6]

◆ find_last_not_of() [6/6]

◆ find_last_of() [1/6]

◆ find_last_of() [2/6]

◆ find_last_of() [3/6]

◆ find_last_of() [4/6]

◆ find_last_of() [5/6]

◆ find_last_of() [6/6]

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