Простейший класс иммутабельной не владеющей строки. Подробнее...

#include <strexpr.h>

Граф наследования:simstr::str_src< K >:

Открытые члены
template<typename T, size_t N = const_lit_for<K, T>::Count>
constexpr	str_src (T &&v) noexcept
	Конструктор из строкового литерала.

constexpr	str_src (const K *p, size_t l) noexcept
	Конструктор из указателя и длины.

template<typename A>
constexpr	str_src (const std::basic_string< K, std::char_traits< K >, A > &s) noexcept
	Конструктор из std::basic_string.

constexpr	str_src (const std::basic_string_view< K, std::char_traits< K > > &s) noexcept
	Конструктор из std::basic_string_view.

constexpr size_t	length () const noexcept
	Получить длину строки.

constexpr const symb_type *	symbols () const noexcept
	Получить указатель на константный буфер с символами строки.

constexpr bool	is_empty () const noexcept
	Проверить, не пуста ли строка.

constexpr bool	is_same (str_src< K > other) const noexcept
	Проверить, не указывают ли два объекта на одну строку.

constexpr bool	is_part_of (str_src< K > other) const noexcept
	Проверить, не является ли строка частью другой строки.

constexpr K	operator[] (size_t idx) const
	Получить символ из указанной позиции. Проверка границ не выполняется.

constexpr my_type &	remove_prefix (size_t delta)
	Сдвигает начало строки на заданное количество символов.

constexpr my_type &	remove_suffix (size_t delta)
	Укорачивает строку на заданное количество символов.

constexpr K *	place (K *ptr) const noexcept
	Копировать строку в указанный буфер.

void	copy_to (K *buffer, size_t bufSize)
	Копировать строку в указанный буфер.

constexpr size_t	size () const
	Размер строки в символах.

constexpr std::basic_string_view< D >	to_sv () const noexcept
	Конвертировать в std::basic_string_view.

constexpr	operator std::basic_string_view< D, Traits > () const
	Конвертировать в std::basic_string_view.

constexpr std::basic_string< D, Traits, Allocator >	to_string () const
	Конвертировать в std::basic_string.

constexpr	operator std::basic_string< D, Traits, Allocator > () const
	Конвертировать в std::basic_string.

constexpr	operator str_piece () const noexcept
	Преобразовать себя в "кусок строки", включающий всю строку.

constexpr str_piece	to_str () const noexcept
	Преобразовать себя в "кусок строки", включающий всю строку.

constexpr str_piece	operator() (ptrdiff_t from, ptrdiff_t len=0) const noexcept
	Получить часть строки как "str_src".

constexpr str_piece	mid (size_t from, size_t len=-1) const noexcept
	Получить часть строки как "кусок строки".

constexpr str_piece	from_to (size_t from, size_t to) const noexcept
	Получить подстроку str_src с позиции от from до позиции to (не включая её).

constexpr bool	operator! () const noexcept
	Проверка на пустоту.

constexpr K	at (ptrdiff_t idx) const
	Получить символ на заданной позиции .

constexpr int	compare (str_piece o) const
	Сравнение строк посимвольно.

constexpr int	strcmp (const K *text) const
	Сравнение с C-строкой посимвольно.

constexpr bool	equal (str_piece other) const noexcept
	Сравнение строк на равенство.

constexpr bool	operator== (const base &other) const noexcept
	Оператор сравнение строк на равенство.

constexpr bool	operator== (T &&other) const noexcept
	Оператор сравнения строки и строкового литерала на равенство.

constexpr auto	operator<=> (const base &other) const noexcept
	Оператор сравнения строк.

constexpr auto	operator<=> (T &&other) const noexcept
	Оператор сравнения строки и строкового литерала.

constexpr int	compare_ia (str_piece text) const noexcept
	Сравнение строк посимвольно без учёта регистра ASCII символов.

constexpr bool	equal_ia (str_piece text) const noexcept
	Равна ли строка другой строке посимвольно без учёта регистра ASCII символов.

constexpr bool	less_ia (str_piece text) const noexcept
	Меньше ли строка другой строки посимвольно без учёта регистра ASCII символов.

constexpr size_t	find (str_piece pattern, size_t offset=0) const noexcept
	Найти начало первого вхождения подстроки в этой строке.

constexpr size_t	find (K s, size_t offset=0) const noexcept
	Найти символ в этой строке.

constexpr size_t	find_or_throw (str_piece pattern, size_t offset=0, Args &&... args) const noexcept
	Найти начало первого вхождения подстроки в этой строке или выкинуть исключение.

constexpr size_t	find_end (str_piece pattern, size_t offset=0) const noexcept
	Найти конец вхождения подстроки в этой строке.

constexpr size_t	find_or_all (str_piece pattern, size_t offset=0) const noexcept
	Найти начало первого вхождения подстроки в этой строке или конец строки.

constexpr size_t	find_or_all (K s, size_t offset=0) const noexcept
	Найти символ в этой строке или конец строки.

constexpr size_t	find_end_or_all (str_piece pattern, size_t offset=0) const noexcept
	Найти конец первого вхождения подстроки в этой строке или конец строки.

constexpr size_t	find_last (str_piece pattern, size_t offset=-1) const noexcept
	Найти начало последнего вхождения подстроки в этой строке.

constexpr size_t	find_last (K s, size_t offset=-1) const noexcept
	Найти последнее вхождения символа в этой строке.

constexpr size_t	find_end_of_last (str_piece pattern, size_t offset=-1) const noexcept
	Найти конец последнего вхождения подстроки в этой строке.

constexpr size_t	find_last_or_all (str_piece pattern, size_t offset=-1) const noexcept
	Найти начало последнего вхождения подстроки в этой строке или конец строки.

constexpr size_t	find_end_of_last_or_all (str_piece pattern, size_t offset=-1) const noexcept
	Найти конец последнего вхождения подстроки в этой строке или конец строки.

constexpr bool	contains (str_piece pattern, size_t offset=0) const noexcept
	Содержит ли строка указанную подстроку.

constexpr void	for_all_finded (const Op &op, str_piece pattern, size_t offset=0, size_t maxCount=0) const
	Вызвать функтор для всех найденных вхождений подстроки в этой строке.

constexpr To	find_all (str_piece pattern, size_t offset=0, size_t maxCount=0) const
	Найти все вхождения подстроки в этой строке.

constexpr size_t	find_first_of (str_piece pattern, size_t offset=0) const noexcept
	Найти первое вхождение символа из заданного набора символов.

constexpr std::pair< size_t, size_t >	find_first_of_idx (str_piece pattern, size_t offset=0) const noexcept
	Найти первое вхождение символа из заданного набора символов.

constexpr size_t	find_first_not_of (str_piece pattern, size_t offset=0) const noexcept
	Найти первое вхождение символа не из заданного набора символов.

constexpr size_t	find_last_of (str_piece pattern, size_t offset=str::npos) const noexcept
	Найти последнее вхождение символа из заданного набора символов.

constexpr std::pair< size_t, size_t >	find_last_of_idx (str_piece pattern, size_t offset=str::npos) const noexcept
	Найти последнее вхождение символа из заданного набора символов.

constexpr size_t	find_last_not_of (str_piece pattern, size_t offset=str::npos) const noexcept
	Найти последнее вхождение символа не из заданного набора символов.

constexpr my_type	substr (ptrdiff_t from, ptrdiff_t len=0) const
	Получить подстроку. Работает аналогично operator(), только результат выдает того же типа, к которому применён метод.

constexpr my_type	str_mid (size_t from, size_t len=-1) const
	Получить часть строки объектом того же типа, к которому применён метод, аналогично mid.

constexpr T	as_int () const noexcept
	Преобразовать строку в число заданного типа.

constexpr convert_result< T >	to_int () const noexcept
	Преобразовать строку в число заданного типа.

std::optional< double >	to_double () const noexcept
	Преобразовать строку в double.

std::optional< double >	to_double_hex () const noexcept
	Преобразовать строку в 16ричной записи в double. Пока работает только для char.

constexpr void	as_number (T &t) const
	Преобразовать строку в целое число.

constexpr T	splitf (str_piece delimiter, const Op &beforeFunc, size_t offset=0) const
	Разделить строку на части по заданному разделителю, с возможным применением функтора к каждой подстроке.

constexpr T	split (str_piece delimiter, size_t offset=0) const
	Разделить строку на подстроки по заданному разделителю.

constexpr bool	starts_with (str_piece prefix) const noexcept
	Начинается ли строка с заданной подстроки.

constexpr bool	starts_with_ia (str_piece prefix) const noexcept
	Начинается ли строка с заданной подстроки без учёта регистра ASCII символов.

constexpr bool	prefix_in (str_piece text) const noexcept
	Является ли эта строка началом другой строки.

constexpr bool	ends_with (str_piece suffix) const noexcept
	Заканчивается ли строка указанной подстрокой.

constexpr bool	ends_with_ia (str_piece suffix) const noexcept
	Заканчивается ли строка указанной подстрокой без учёта регистра ASCII символов.

constexpr bool	is_ascii () const noexcept
	Содержит ли строка только ASCII символы.

R	upperred_only_ascii () const
	Получить копию строки в верхнем регистре ASCII символов.

R	lowered_only_ascii () const
	Получить копию строки в нижнем регистре ASCII символов.

R	replaced (str_piece pattern, str_piece repl, size_t offset=0, size_t maxCount=0) const
	Получить копию строки с заменёнными вхождениями подстрок.

constexpr R	trimmed () const
	Получить строку с удалением пробельных символов слева и справа.

R	trimmed (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, слева и справа.

R	trimmed (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, слева и справа.

R	trimmed_left () const
	Получить строку с удалением пробельных символов слева.

R	trimmed_left (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, слева.

R	trimmed_left (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, слева.

R	trimmed_right () const
	Получить строку с удалением пробельных символов справа.

R	trimmed_right (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, справа.

R	trimmed_right (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, справа.

R	trimmed_with_spaces (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, слева и справа.

R	trimmed_with_spaces (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, слева и справа.

R	trimmed_left_with_spaces (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, слева.

R	trimmed_left_with_spaces (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, слева.

R	trimmed_right_with_spaces (T &&pattern) const
	Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, справа.

R	trimmed_right_with_spaces (str_piece pattern) const
	Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, справа.

constexpr SplitterBase< K, str_piece >	splitter (str_piece delimiter) const
	Получить объект `Splitter` по заданному разделителю, который позволяет последовательно получать подстроки методом `next()`, пока `is_done()` false.

Подробное описание

template<typename K>
struct simstr::str_src< K >

Простейший класс иммутабельной не владеющей строки.

Этот класс заменяет simple_str, если вы используете только "strexpr.h". Аналог std::string_view. Содержит только указатель и длину. Как наследник от str_algs поддерживает все константные строковые методы, за исключением парсинга double из любых типов символов - поддерживаются только char, wchar_t, и совместимые с ними по размеру символы. Также не содержит работы с упрощённым юникодом.

Параметры шаблона

K	- тип символов строки.

Методы

◆ as_int()

T simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::as_int ( ) const

inlineconstexprnoexceptinherited

Преобразовать строку в число заданного типа.

Параметры шаблона

T	- желаемый тип числа.
CheckOverflow	- проверять на переполнение.
Base	- основание счисления числа, от -1 до 36, кроме 1. Если 0: то пытается определить основание по префиксу 0[xX] как 16, 0 как 8, иначе 10. Если -1: то пытается определить основание по префиксам: 0 или 0[oO]: 8 0[bB]: 2 0[xX]: 16 в остальных случаях 10.
SkipWs	- пропускать пробельные символы в начале строки.
AllowSign	- допустим ли знак '+' перед числом.

Возвращает: T - число, результат преобразования, насколько оно получилось, или 0 при переполнении.

◆ as_number()

void simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::as_number ( T & t ) const

inlineconstexprinherited

Преобразовать строку в целое число.

Параметры шаблона

T	- тип числа, выводится из аргумента.

Аргументы

t	- переменная, в которую записывается результат.

◆ at()

K simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::at ( ptrdiff_t idx ) const

inlineconstexprinherited

Получить символ на заданной позиции .

Аргументы

idx	- индекс символа. Для отрицательных значений отсчитывается от конца строки.

Возвращает: K - символ.

Не производит проверку на выход за границы строки.

◆ compare()

int simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::compare ( str_piece o ) const

inlineconstexprinherited

Сравнение строк посимвольно.

Аргументы

o	- другая строка.

Возвращает: <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.

◆ compare_ia()

int simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::compare_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

Сравнение строк посимвольно без учёта регистра ASCII символов.

Аргументы

text	- другая строка.

Возвращает: <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.

◆ contains()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::contains	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Содержит ли строка указанную подстроку.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.

Возвращает: bool.

◆ copy_to()

void simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::copy_to	(	K *	buffer,
		size_t	bufSize )

inlineinherited

Копировать строку в указанный буфер.

Метод добавляет \0 после скопированных символов. Не выходит за границы буфера.

Аргументы

buffer	- указатель на буфер
bufSize	- размер буфера в символах.

◆ ends_with()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::ends_with ( str_piece suffix ) const

inlineconstexprnoexceptinherited

Заканчивается ли строка указанной подстрокой.

Аргументы

suffix - подстрока.

◆ ends_with_ia()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::ends_with_ia ( str_piece suffix ) const

inlineconstexprnoexceptinherited

Заканчивается ли строка указанной подстрокой без учёта регистра ASCII символов.

Аргументы

suffix - подстрока.

◆ equal()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::equal ( str_piece other ) const

inlineconstexprnoexceptinherited

Сравнение строк на равенство.

Аргументы

other - другая строка.

Возвращает: равны ли строки.

◆ equal_ia()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::equal_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

Равна ли строка другой строке посимвольно без учёта регистра ASCII символов.

Аргументы

text	- другая строка.

Возвращает: равны ли строки.

◆ find() [1/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find	(	K	s,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти символ в этой строке.

Аргументы

s	- искомый символ.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию найденного символа, или -1, если не найден.

◆ find() [2/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти начало первого вхождения подстроки в этой строке.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию начала вхождения подстроки, или -1, если не найдена.

◆ find_all()

To simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_all	(	str_piece	pattern,
		size_t	offset = 0,
		size_t	maxCount = 0 ) const

inlineconstexprinherited

Найти все вхождения подстроки в этой строке.

Аргументы

pattern	- искомая подстрока.
offset	- позиция начала поиска.
maxCount	- максимальное количество обрабатываемых вхождений, 0 - без ограничений.

Возвращает: std::vector<size_t> - вектор с позициями начал найденных вхождений.

◆ find_end()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_end	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти конец вхождения подстроки в этой строке.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию сразу за вхождением подстроки, или -1, если не найдена.

◆ find_end_of_last()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_end_of_last	(	str_piece	pattern,
		size_t	offset = -1 ) const

inlineconstexprnoexceptinherited

Найти конец последнего вхождения подстроки в этой строке.

Аргументы

pattern	- искомая строка.
offset	- c какой позиции вести поиск в обратную сторону, -1 - с самого конца.

Возвращает: size_t - позицию сразу за последним вхождением подстроки, или -1, если не найдена.

◆ find_end_of_last_or_all()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_end_of_last_or_all	(	str_piece	pattern,
		size_t	offset = -1 ) const

inlineconstexprnoexceptinherited

Найти конец последнего вхождения подстроки в этой строке или конец строки.

Аргументы

pattern	- искомая строка.
offset	- c какой позиции вести поиск в обратную сторону, -1 - с самого конца.

Возвращает: size_t - позицию сразу за последним вхождением подстроки, или длину строки, если не найдена.

◆ find_end_or_all()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_end_or_all	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти конец первого вхождения подстроки в этой строке или конец строки.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию сразу за вхождением подстроки, или длину строки, если не найдена.

◆ find_first_not_of()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_first_not_of	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти первое вхождение символа не из заданного набора символов.

Аргументы

pattern	- строка, задающая набор символов.
offset	- позиция начала поиска.

Возвращает: size_t - позицию найденного вхождения, или -1, если не найден.

◆ find_first_of()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_first_of	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти первое вхождение символа из заданного набора символов.

Аргументы

pattern	- строка, задающая набор искомых символов.
offset	- позиция начала поиска.

Возвращает: size_t - позицию найденного вхождения, или -1, если не найден.

◆ find_first_of_idx()

std::pair< size_t, size_t > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_first_of_idx	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти первое вхождение символа из заданного набора символов.

Аргументы

pattern	- строка, задающая набор искомых символов.
offset	- позиция начала поиска.

Возвращает: std::pair<size_t, size_t> - пару из позиции найденного вхождения и номера найденного символа в наборе, или -1, если не найден.

◆ find_last() [1/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last	(	K	s,
		size_t	offset = -1 ) const

inlineconstexprnoexceptinherited

Найти последнее вхождения символа в этой строке.

Аргументы

s	- искомый символ.
offset	- c какой позиции вести поиск в обратную сторону, -1 - с самого конца.

Возвращает: size_t - позицию найденного символа, или -1, если не найден.

◆ find_last() [2/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last	(	str_piece	pattern,
		size_t	offset = -1 ) const

inlineconstexprnoexceptinherited

Найти начало последнего вхождения подстроки в этой строке.

Аргументы

pattern	- искомая строка.
offset	- c какой позиции вести поиск в обратную сторону, -1 - с самого конца.

Возвращает: size_t - позицию начала вхождения подстроки, или -1, если не найдена.

◆ find_last_not_of()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last_not_of	(	str_piece	pattern,
		size_t	offset = str::npos ) const

inlineconstexprnoexceptinherited

Найти последнее вхождение символа не из заданного набора символов.

Аргументы

pattern	- строка, задающая набор символов.
offset	- позиция начала поиска.

Возвращает: size_t - позицию найденного вхождения, или -1, если не найден.

◆ find_last_of()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last_of	(	str_piece	pattern,
		size_t	offset = str::npos ) const

inlineconstexprnoexceptinherited

Найти последнее вхождение символа из заданного набора символов.

Аргументы

pattern	- строка, задающая набор искомых символов.
offset	- позиция начала поиска.

Возвращает: size_t - позицию найденного вхождения, или -1, если не найден.

◆ find_last_of_idx()

std::pair< size_t, size_t > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last_of_idx	(	str_piece	pattern,
		size_t	offset = str::npos ) const

inlineconstexprnoexceptinherited

Найти последнее вхождение символа из заданного набора символов.

Аргументы

pattern	- строка, задающая набор искомых символов.
offset	- позиция начала поиска.

Возвращает: std::pair<size_t, size_t> - пару из позиции найденного вхождения и номера найденного символа в наборе, или -1, если не найден.

◆ find_last_or_all()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_last_or_all	(	str_piece	pattern,
		size_t	offset = -1 ) const

inlineconstexprnoexceptinherited

Найти начало последнего вхождения подстроки в этой строке или конец строки.

Аргументы

pattern	- искомая строка.
offset	- c какой позиции вести поиск в обратную сторону, -1 - с самого конца.

Возвращает: size_t - позицию начала вхождения подстроки, или длину строки, если не найдена.

◆ find_or_all() [1/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_or_all	(	K	s,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти символ в этой строке или конец строки.

Аргументы

s	- искомый символ.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию найденного символа, или длину строки, если не найден.

◆ find_or_all() [2/2]

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_or_all	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

Найти начало первого вхождения подстроки в этой строке или конец строки.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.

Возвращает: size_t - позицию начала вхождения подстроки, или длину строки, если не найдена.

◆ find_or_throw()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::find_or_throw	(	str_piece	pattern,
		size_t	offset = 0,
		Args &&...	args ) const

inlineconstexprnoexceptinherited

Найти начало первого вхождения подстроки в этой строке или выкинуть исключение.

Параметры шаблона

Exc	- тип исключения.
Args...	- типы параметров для конструирования исключения, выводятся из аргументов.

Аргументы

pattern	- искомая строка.
offset	- с какой позиции начинать поиск.
args	- аргументы для конструктора исключения.

Возвращает: size_t - позицию начала вхождения подстроки, или выбрасывает исключение Exc, если не найдена.

◆ for_all_finded()

void simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::for_all_finded	(	const Op &	op,
		str_piece	pattern,
		size_t	offset = 0,
		size_t	maxCount = 0 ) const

inlineconstexprinherited

Вызвать функтор для всех найденных вхождений подстроки в этой строке.

Аргументы

op	- функтор, принимающий строку.
pattern	- искомая подстрока.
offset	- позиция начала поиска.
maxCount	- максимальное количество обрабатываемых вхождений, 0 - без ограничений.

◆ from_to()

str_piece simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::from_to	(	size_t	from,
		size_t	to ) const

inlineconstexprnoexceptinherited

Получить подстроку str_src с позиции от from до позиции to (не включая её).

Для производительности метод никак не проверяет выходы за границы строки, используйте в сценариях, когда точно знаете, что это позиции внутри строки и to >= from.

Аргументы

from	- начальная позиция.
to	- конечная позиция (не входит в результат).

Возвращает: Подстроку, str_src.

◆ is_part_of()

template<typename K>

bool simstr::str_src< K >::is_part_of ( str_src< K > other ) const

inlineconstexprnoexcept

Проверить, не является ли строка частью другой строки.

Аргументы

other - другая строка.

◆ is_same()

template<typename K>

bool simstr::str_src< K >::is_same ( str_src< K > other ) const

inlineconstexprnoexcept

Проверить, не указывают ли два объекта на одну строку.

Аргументы

other - другая строка.

◆ less_ia()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::less_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

Меньше ли строка другой строки посимвольно без учёта регистра ASCII символов.

Аргументы

text	- другая строка.

Возвращает: меньше ли строка.

◆ lowered_only_ascii()

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::lowered_only_ascii ( ) const

inlineinherited

Получить копию строки в нижнем регистре ASCII символов.

Параметры шаблона

R	- желаемый тип строки, по умолчанию тот же, чей метод вызывался.

Возвращает: R - копию строки в нижнем регистре.

◆ mid()

str_piece simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::mid	(	size_t	from,
		size_t	len = -1 ) const

inlineconstexprnoexceptinherited

Получить часть строки как "кусок строки".

Аргументы

from	- количество символов от начала строки. При превышении размера строки вернёт пустую строку.
len	- количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки.

Возвращает: Подстроку, str_src.

◆ operator std::basic_string< D, Traits, Allocator >()

simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator std::basic_string< D, Traits, Allocator > ( ) const

inlineconstexprinherited

Конвертировать в std::basic_string.

Возвращает: std::basic_string<K>.

◆ operator std::basic_string_view< D, Traits >()

simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator std::basic_string_view< D, Traits > ( ) const

inlineconstexprinherited

Конвертировать в std::basic_string_view.

Возвращает: std::basic_string_view<K>.

◆ operator str_piece()

simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator str_piece ( ) const

inlineconstexprnoexceptinherited

Преобразовать себя в "кусок строки", включающий всю строку.

Возвращает: str_piece.

◆ operator()()

str_piece simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator()	(	ptrdiff_t	from,
		ptrdiff_t	len = 0 ) const

inlineconstexprnoexceptinherited

Получить часть строки как "str_src".

Аргументы

from	- количество символов от начала строки.
len	- количество символов в получаемом "куске".

Возвращает: Подстроку, str_src.

Если from меньше нуля, то отсчитывается -from символов от конца строки в сторону начала. Если len меньше или равно нулю, то отсчитать -len символов от конца строки

"0123456789"_ss(5, 2) == "56";
"0123456789"_ss(5) == "56789";
"0123456789"_ss(5, -1) == "5678";
"0123456789"_ss(-3) == "789";
"0123456789"_ss(-3, 2) == "78";
"0123456789"_ss(-4, -1) == "678";

◆ operator<=>() [1/2]

auto simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator<=> ( const base & other ) const

inlineconstexprnoexceptinherited

Оператор сравнения строк.

Аргументы

other - другая строка.

◆ operator<=>() [2/2]

auto simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator<=> ( T && other ) const

inlineconstexprnoexceptinherited

Оператор сравнения строки и строкового литерала.

Аргументы

other - строковый литерал.

◆ operator==() [1/2]

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator== ( const base & other ) const

inlineconstexprnoexceptinherited

Оператор сравнение строк на равенство.

Аргументы

other - другая строка.

Возвращает: равны ли строки.

◆ operator==() [2/2]

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::operator== ( T && other ) const

inlineconstexprnoexceptinherited

Оператор сравнения строки и строкового литерала на равенство.

Аргументы

other - строковый литерал.

◆ operator[]()

template<typename K>

K simstr::str_src< K >::operator[] ( size_t idx ) const

inlineconstexpr

Получить символ из указанной позиции. Проверка границ не выполняется.

Аргументы

idx	- позиция символа.

Возвращает: K - символ.

◆ place()

K * simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::place ( K * ptr ) const

inlineconstexprnoexceptinherited

Копировать строку в указанный буфер.

Метод предполагает, что размер выделенного буфера достаточен для всей строки, т.е. предварительно была запрошена length(). Не добавляет \0.

Аргументы

ptr	- указатель на буфер.

Возвращает: указатель на символ после конца размещённой в буфере строки.

◆ prefix_in()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::prefix_in ( str_piece text ) const

inlineconstexprnoexceptinherited

Является ли эта строка началом другой строки.

Аргументы

text	- другая строка.

◆ remove_prefix()

template<typename K>

my_type & simstr::str_src< K >::remove_prefix ( size_t delta )

inlineconstexpr

Сдвигает начало строки на заданное количество символов.

Аргументы

delta - количество символов.

Возвращает: my_type&.

◆ remove_suffix()

template<typename K>

my_type & simstr::str_src< K >::remove_suffix ( size_t delta )

inlineconstexpr

Укорачивает строку на заданное количество символов.

Аргументы

delta - количество символов.

Возвращает: my_type&.

◆ replaced()

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::replaced	(	str_piece	pattern,
		str_piece	repl,
		size_t	offset = 0,
		size_t	maxCount = 0 ) const

inlineinherited

Получить копию строки с заменёнными вхождениями подстрок.

Параметры шаблона

R	- желаемый тип строки, по умолчанию тот же, чей метод вызывался.

Аргументы

pattern	- искомая подстрока.
repl	- строка, на которую заменять.
offset	- начальная позиция поиска.
maxCount	- максимальное количество замен, 0 - без ограничений.

Возвращает: R строку заданного типа, по умолчанию того же, чей метод вызывался.

◆ size()

size_t simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::size ( ) const

inlineconstexprinherited

Размер строки в символах.

Возвращает: size_t

◆ split()

T simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::split	(	str_piece	delimiter,
		size_t	offset = 0 ) const

inlineconstexprinherited

Разделить строку на подстроки по заданному разделителю.

Параметры шаблона

T	- тип контейнера для результата.

Аргументы

delimiter	- разделитель.
offset	- позиция начала поиска разделителя.

Возвращает: T - контейнер с результатом.

◆ splitf()

T simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::splitf	(	str_piece	delimiter,
		const Op &	beforeFunc,
		size_t	offset = 0 ) const

inlineconstexprinherited

Разделить строку на части по заданному разделителю, с возможным применением функтора к каждой подстроке.

Параметры шаблона

T	- тип контейнера для складывания подстрок.

Аргументы

delimiter	- подстрока разделитель.
beforeFunc	- функтор для применения к найденным подстрокам, перед помещением их в результат.
offset	- позиция начала поиска разделителя.

Возвращает: T - результат.

Для каждой найденной подстроки, если функтор может принять её, вызывается функтор, и подстрока присваивается результату функтора. Далее подстрока пытается добавиться в результат, вызывая один из его методов - emplace_back, push_back, operator[]. Если ни одного этого метода нет, ничего не делается, только вызов функтора. operator[] пытается применится, если у результата можно получить размер через std::size и мы не выходим за этот размер. При этом, если найденная подстрока получается совпадающей со всей строкой - в результат пытается поместить не подстроку, а весь объект строки, что позволяет, например, эффективно копировать sstring.

◆ splitter()

SplitterBase< K, str_piece > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::splitter ( str_piece delimiter ) const

inlineconstexprinherited

Получить объект Splitter по заданному разделителю, который позволяет последовательно получать подстроки методом next(), пока is_done() false.

Аргументы

delimiter - разделитель.

Возвращает: Splitter<K>.

◆ starts_with()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::starts_with ( str_piece prefix ) const

inlineconstexprnoexceptinherited

Начинается ли строка с заданной подстроки.

Аргументы

prefix - подстрока.

◆ starts_with_ia()

bool simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::starts_with_ia ( str_piece prefix ) const

inlineconstexprnoexceptinherited

Начинается ли строка с заданной подстроки без учёта регистра ASCII символов.

Аргументы

prefix - подстрока.

◆ str_mid()

my_type simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::str_mid	(	size_t	from,
		size_t	len = -1 ) const

inlineconstexprinherited

Получить часть строки объектом того же типа, к которому применён метод, аналогично mid.

Аргументы

from	- количество символов от начала строки. При превышении размера строки вернёт пустую строку.
len	- количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки.

Возвращает: Строку того же типа, к которому применён метод.

◆ strcmp()

int simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::strcmp ( const K * text ) const

inlineconstexprinherited

Сравнение с C-строкой посимвольно.

Аргументы

text	- другая строка.

Возвращает: <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.

◆ substr()

my_type simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::substr	(	ptrdiff_t	from,
		ptrdiff_t	len = 0 ) const

inlineconstexprinherited

Получить подстроку. Работает аналогично operator(), только результат выдает того же типа, к которому применён метод.

Аргументы

from	- количество символов от начала строки. Если меньше нуля, отсчитывается от конца строки в сторону начала.
len	- количество символов в получаемом "куске". Если меньше или равно нулю, то отсчитать len символов от конца строки.

Возвращает: my_type - подстроку, объект того же типа, к которому применён метод.

◆ to_double()

std::optional< double > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_double ( ) const

inlinenoexceptinherited

Преобразовать строку в double.

Возвращает: std::optional<double>.

◆ to_double_hex()

std::optional< double > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_double_hex ( ) const

inlinenoexceptinherited

Преобразовать строку в 16ричной записи в double. Пока работает только для char.

Возвращает: std::optional<double>.

◆ to_int()

convert_result< T > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_int ( ) const

inlineconstexprnoexceptinherited

Преобразовать строку в число заданного типа.

Параметры шаблона

T	- желаемый тип числа.
CheckOverflow	- проверять на переполнение.
Base	- основание счисления числа, от -1 до 36, кроме 1. Если 0: то пытается определить основание по префиксу 0[xX] как 16, 0 как 8, иначе 10 Если -1: то пытается определить основание по префиксам: 0 или 0[oO]: 8 0[bB]: 2 0[xX]: 16 в остальных случаях 10.
SkipWs	- пропускать пробельные символы в начале строки. Пропускаются все символы с ASCII кодами <= 32.
AllowSign	- допустим ли знак '+' перед числом.

Возвращает: convert_result<T> - кортеж из полученного числа, успешности преобразования и количестве обработанных символов.

◆ to_str()

str_piece simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_str ( ) const

inlineconstexprnoexceptinherited

Преобразовать себя в "кусок строки", включающий всю строку.

Возвращает: str_piece.

◆ to_string()

std::basic_string< D, Traits, Allocator > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_string ( ) const

inlineconstexprinherited

Конвертировать в std::basic_string.

Возвращает: std::basic_string<K>.

◆ to_sv()

std::basic_string_view< D > simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::to_sv ( ) const

inlineconstexprnoexceptinherited

Конвертировать в std::basic_string_view.

Возвращает: std::basic_string_view<K>.

◆ trimmed() [1/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed ( ) const

inlineconstexprinherited

Получить строку с удалением пробельных символов слева и справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Возвращает: R - строка, с удалёнными в начале и в конце пробельными символами.

◆ trimmed() [2/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, слева и справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале и в конце символами, содержащимися в шаблоне.

◆ trimmed() [3/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, слева и справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале и в конце символами, содержащимися в литерале.

◆ trimmed_left() [1/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_left ( ) const

inlineinherited

Получить строку с удалением пробельных символов слева.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Возвращает: R - строка, с удалёнными в начале пробельными символами.

◆ trimmed_left() [2/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_left ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, слева.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале символами, содержащимися в шаблоне.

◆ trimmed_left() [3/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_left ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, слева.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале символами, содержащимися в литерале.

◆ trimmed_left_with_spaces() [1/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_left_with_spaces ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, слева.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале символами, содержащимися в шаблоне и пробельными символами.

◆ trimmed_left_with_spaces() [2/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_left_with_spaces ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, слева.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале символами, содержащимися в литерале и пробельными символами.

◆ trimmed_right() [1/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_right ( ) const

inlineinherited

Получить строку с удалением пробельных символов справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Возвращает: R - строка, с удалёнными в конце пробельными символами.

◆ trimmed_right() [2/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_right ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в конце символами, содержащимися в шаблоне.

◆ trimmed_right() [3/3]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_right ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в конце символами, содержащимися в литерале.

◆ trimmed_right_with_spaces() [1/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_right_with_spaces ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в конце символами, содержащимися в шаблоне и пробельными символами.

◆ trimmed_right_with_spaces() [2/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_right_with_spaces ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в конце символами, содержащимися в литерале и пробельными символами.

◆ trimmed_with_spaces() [1/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_with_spaces ( str_piece pattern ) const

inlineinherited

Получить строку с удалением символов, заданных другой строкой, а также пробельных символов, слева и справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строка, задающая символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале и в конце символами, содержащимися в шаблоне и пробельными символами.

◆ trimmed_with_spaces() [2/2]

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::trimmed_with_spaces ( T && pattern ) const

inlineinherited

Получить строку с удалением символов, заданных строковым литералом, а также пробельных символов, слева и справа.

Параметры шаблона

R	- желаемый тип строки, по умолчанию str_src.

Аргументы

pattern - строковый литерал, задающий символы, которые будут обрезаться.

Возвращает: R - строка, с удалёнными в начале и в конце символами, содержащимися в литерале и пробельными символами.

◆ upperred_only_ascii()

R simstr::str_src_algs< K, str_src< K >, str_src< K >, Mutable >::upperred_only_ascii ( ) const

inlineinherited

Получить копию строки в верхнем регистре ASCII символов.

Параметры шаблона

R	- желаемый тип строки, по умолчанию тот же, чей метод вызывался.

Возвращает: R - копию строки в верхнем регистре.

Объявления и описания членов структуры находятся в файле:

strexpr.h

Открытые члены

Подробное описание

Методы

◆ as_int()

◆ as_number()

◆ at()

◆ compare()

◆ compare_ia()

◆ contains()

◆ copy_to()

◆ ends_with()

◆ ends_with_ia()

◆ equal()

◆ equal_ia()

◆ find() [1/2]

◆ find() [2/2]

◆ find_all()

◆ find_end()

◆ find_end_of_last()

◆ find_end_of_last_or_all()

◆ find_end_or_all()

◆ find_first_not_of()

◆ find_first_of()

◆ find_first_of_idx()

◆ find_last() [1/2]

◆ find_last() [2/2]

◆ find_last_not_of()

◆ find_last_of()

◆ find_last_of_idx()

◆ find_last_or_all()

◆ find_or_all() [1/2]

◆ find_or_all() [2/2]

◆ find_or_throw()

◆ for_all_finded()

◆ from_to()

◆ is_part_of()

◆ is_same()

◆ less_ia()

◆ lowered_only_ascii()

◆ mid()

◆ operator std::basic_string< D, Traits, Allocator >()

◆ operator std::basic_string_view< D, Traits >()

◆ operator str_piece()

◆ operator()()

◆ operator<=>() [1/2]

◆ operator<=>() [2/2]

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ operator[]()

◆ place()

◆ prefix_in()

◆ remove_prefix()

◆ remove_suffix()

◆ replaced()

◆ size()

◆ split()

◆ splitf()

◆ splitter()

◆ starts_with()

◆ starts_with_ia()

◆ str_mid()

◆ strcmp()

◆ substr()

◆ to_double()

◆ to_double_hex()

◆ to_int()

◆ to_str()

◆ to_string()

◆ to_sv()

◆ trimmed() [1/3]

◆ trimmed() [2/3]

◆ trimmed() [3/3]

◆ trimmed_left() [1/3]

◆ trimmed_left() [2/3]

◆ trimmed_left() [3/3]

◆ trimmed_left_with_spaces() [1/2]

◆ trimmed_left_with_spaces() [2/2]

◆ trimmed_right() [1/3]

◆ trimmed_right() [2/3]

◆ trimmed_right() [3/3]