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

#include <sstring.h>

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

Открытые члены
template<typename... Args> requires (std::is_constructible_v<allocator_t, Args...> && sizeof...(Args) > 0)
	sstring (Args &&... args) noexcept(std::is_nothrow_constructible_v< allocator_t, Args... >)
	Конструктор пустой строки.

template<typename... Args> requires std::is_constructible_v<allocator_t, Args...>
	sstring (s_str other, Args &&... args)
	Конструктор из другого строкового объекта.

template<typename... Args> requires std::is_constructible_v<allocator_t, Args...>
	sstring (size_t repeat, s_str pattern, Args &&... args)
	Конструктор повторения строки.

template<typename... Args> requires std::is_constructible_v<allocator_t, Args...>
	sstring (size_t count, K pad, Args &&... args)
	Конструктор повторения символа.

template<typename... Args> requires std::is_constructible_v<allocator_t, Args...>
constexpr	sstring (const StrExprForType< K > auto &expr, Args &&... args)
	Конструктор из строкового выражения.

template<StrType< K > From, typename... Args> requires std::is_constructible_v<allocator_t, Args...>
	sstring (const From &f, s_str pattern, s_str repl, size_t offset=0, size_t maxCount=0, Args &&... args)
	Конструктор из строкового источника с заменой.

constexpr	~sstring ()
	Деструктор строки.

constexpr	sstring (const my_type &other) noexcept
	Конструктор копирования строки.

constexpr	sstring (my_type &&other) noexcept
	Конструктор перемещения.

template<size_t N>
constexpr	sstring (lstring< K, N, true, Allocator > &&src)
	Конструктор перемещения из lstring с совместимым с sstring внешним буфером.

template<typename T, size_t N = const_lit_for<K, T>::Count, typename... Args> requires std::is_constructible_v<allocator_t, Args...>
	sstring (T &&s, Args &&... args)
	Инициализация из строкового литерала.

template<typename O> requires (!std::is_same_v<O, K>)
	sstring (simple_str< O > init)
	Инициализация из строкового источника с другим типом символов. Конвертирует через UTF.

constexpr my_type &	operator= (my_type other) noexcept
	Оператор присвоения другой строки того же типа.

constexpr my_type &	operator= (simple_str< K > other)
	Оператор присвоения другой строки другого типа.

template<typename T, size_t N = const_lit_for<K, T>::Count>
constexpr my_type &	operator= (T &&other)
	Оператор присвоения строкового литерала.

template<size_t N, bool forShared, typename A>
constexpr my_type &	operator= (const lstring< K, N, forShared, A > &other)
	Оператор присвоения другой строки типа lstring.

template<size_t N>
constexpr my_type &	operator= (lstring< K, N, true, Allocator > &&other)
	Оператор присвоения перемещаемой строки типа lstring с совместимым буфером.

constexpr my_type &	operator= (const StrExprForType< K > auto &expr)
	Оператор присвоения строкового выражения.

constexpr my_type &	make_empty () noexcept
	Сделать строку пустой.

constexpr const K *	symbols () const noexcept
	Указатель на символы строки.

constexpr size_t	length () const noexcept
	Длина строки.

constexpr bool	is_empty () const noexcept
	Пустая ли строка.

constexpr bool	empty () const noexcept
	Пустая ли строка, для совместимости с std::string.

int	compare_iu (str_piece text) const noexcept
	Сравнение строк посимвольно без учёта регистра Unicode символов первой плоскости (<0xFFFF).

bool	equal_iu (str_piece text) const noexcept
	Равна ли строка другой строке посимвольно без учёта регистра Unicode символов первой плоскости (<0xFFFF).

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

bool	starts_with_iu (str_piece prefix) const noexcept
	Начинается ли строка с заданной подстроки без учёта регистра Unicode символов первой плоскости (<0xFFFF).

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

R	upperred () const
	Получить копию строки в верхнем регистре Unicode символов первой плоскости (<0xFFFF).

R	lowered () const
	Получить копию строки в нижнем регистре Unicode символов первой плоскости (<0xFFFF).

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

void	as_number (double &t) const
	Преобразовать строку в double.

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

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_hex () const noexcept
	Преобразовать строку в 16ричной записи в double. Пока работает только для char.

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.

constexpr	operator const K * () const noexcept
	Оператор преобразования в нуль-терминированную C-строку.

constexpr s_str_nt	to_nts (size_t from=0) const
	Получить simple_str_nt, начиная с заданного символа.

constexpr	operator s_str_nt () const
	Преобразовать в simple_str_nt.

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

Открытые статические члены
template<typename... T>
static my_type	printf (const K *pattern, T &&... args)
	Получить строку, отформатированную с помощью `std::sprintf`.

template<typename... T>
static my_type	format (const FmtString< typename to_std_char_type< K >::type, T... > &fmtString, T &&... args)
	Получить строку, отформатированную с помощью `std::format`.

template<typename... T>
static my_type	vformat (simple_str< K > fmtString, T &&... args)
	Получить строку, отформатированную с помощью `std::vformat`.

static my_type	join (const T &strings, s_str delimiter, bool tail=false, bool skip_empty=false, Args &&... args)
	Конкатенация строк из контейнера в одну строку.

static my_type	upperred_only_ascii_from (const From &f, Args &&... args)
	Создать строку, копию переданной в верхнем регистре символов ASCII.

static my_type	lowered_only_ascii_from (const From &f, Args &&... args)
	Создать копию переданной строки в нижнем регистре символов ASCII.

static my_type	upperred_from (const From &f, Args &&... args)
	Создать копию переданной строки в верхнем регистре символов Unicode первой плоскости (<0xFFFF).

static my_type	lowered_from (const From &f, Args &&... args)
	Создать копию переданной строки в нижнем регистре символов Unicode первой плоскости (<0xFFFF).

static my_type	replaced_from (const From &f, s_str pattern, s_str repl, size_t offset=0, size_t maxCount=0, Args &&... args)
	Создать копию переданной строки с заменой подстрок.

Защищенные члены
constexpr allocator_t &	allocator ()
	Получить аллокатор.

constexpr void	init_from_str_other (s_str other)
	Инициализация из другого строкового объекта.

constexpr void	init_str_repeat (size_t repeat, s_str pattern)
	Инициализация повторением строки.

constexpr void	init_symb_repeat (size_t count, K pad)
	Инициализация повторением символа.

constexpr void	init_str_expr (const A &expr)
	Инициализация из строкового выражения.

void	init_replaced (const From &f, s_str pattern, s_str repl, size_t offset=0, size_t maxCount=0)
	Инициализация из строкового источника с заменой.

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

template<typename K, Allocatorable Allocator = allocator_string>
class simstr::sstring< K, Allocator >

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

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

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

"shared" строка. Класс с small string optimization плюс разделяемый иммутабельный буфер строки. Так как буфер строки в этом классе иммутабельный, то: Во-первых, нет нужды хранить размер выделенного буфера, мы его всё-равно не будем изменять. Во-вторых, появляется ещё один тип строки - строка, инициализированная строковым литералом. Для неё просто сохраняем указатель на символы, и не считаем ссылки. Таким образом, инициализация строкового объекта в программе литералом - ничего никуда не копирует - ни в себя, ни в динамическую память, и не стоит дороже по сравнению с инициализацией сырого указателя на строку, и даже ещё оптимальнее, так как ещё и сразу подставляет размер, а не вычисляет его в рантайме.

stringa text = "text or very very very long text"; // ничего не стоит!

stringa copy = anotherString; // Стоит только копирование байтов самого объекта плюс возможно один атомарный инкремент

В случае разделяемого буфера размер строки всё-равно храним не в общем буфере, а в каждом объекте. Из-за SSO места всё-равно хватает, а в память лезть за длиной придётся меньше. Например, подсчитать сумму длин строк в векторе - пройдётся только по памяти в векторе.

Размеры для x64:

для u8s - 24 байта, хранит строки до 23 символов + 0
для u16s - 32 байта, хранит строки до 15 символов + 0
для u32s - 32 байта, хранит строки до 7 символов + 0

Конструктор(ы)

◆ sstring() [1/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... Args>
requires (std::is_constructible_v<allocator_t, Args...> && sizeof...(Args) > 0)

simstr::sstring< K, Allocator >::sstring ( Args &&... args )

inlinenoexcept

Конструктор пустой строки.

Аргументы

...args - параметры для инициализации аллокатора.

◆ sstring() [2/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	s_str	other,
		Args &&...	args )

inline

Конструктор из другого строкового объекта.

Аргументы

other	- другой строковый объект, simple_str.
...args	- параметры для инициализации аллокатора.

◆ sstring() [3/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	size_t	repeat,
		s_str	pattern,
		Args &&...	args )

inline

Конструктор повторения строки.

Аргументы

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

◆ sstring() [4/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	size_t	count,
		K	pad,
		Args &&...	args )

inline

Конструктор повторения символа.

Аргументы

count	- количество повторов.
pad	- символ, который надо повторить.
...args	- параметры для инициализации аллокатора.

◆ sstring() [5/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	const StrExprForType< K > auto &	expr,
		Args &&...	args )

inlineconstexpr

Конструктор из строкового выражения.

Аргументы

expr	- строковое выражение.
...args	- параметры для инициализации аллокатора.

Конструктор запрашивает у строкового выражения length(), выделяет память нужного размера, и вызывает метод place() для размещения результата в буфере.

◆ sstring() [6/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<StrType< K > From, typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	const From &	f,
		s_str	pattern,
		s_str	repl,
		size_t	offset = 0,
		size_t	maxCount = 0,
		Args &&...	args )

inline

Конструктор из строкового источника с заменой.

Аргументы

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

◆ sstring() [7/11]

template<typename K, Allocatorable Allocator = allocator_string>

simstr::sstring< K, Allocator >::sstring ( const my_type & other )

inlineconstexprnoexcept

Конструктор копирования строки.

Аргументы

other - копируемая строка.

◆ sstring() [8/11]

template<typename K, Allocatorable Allocator = allocator_string>

simstr::sstring< K, Allocator >::sstring ( my_type && other )

inlineconstexprnoexcept

Конструктор перемещения.

Аргументы

other - перемещаемая строка.

◆ sstring() [9/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<size_t N>

simstr::sstring< K, Allocator >::sstring ( lstring< K, N, true, Allocator > && src )

inlineconstexpr

Конструктор перемещения из lstring с совместимым с sstring внешним буфером.

Аргументы

src	- перемещаемая строка.

В случае, если символы в lstring лежат во внешнем аллоцированном буфере, просто забираем указатель на буфер, он нам подойдёт.

◆ sstring() [10/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename T, size_t N = const_lit_for<K, T>::Count, typename... Args>
requires std::is_constructible_v<allocator_t, Args...>

simstr::sstring< K, Allocator >::sstring	(	T &&	s,
		Args &&...	args )

inline

Инициализация из строкового литерала.

Аргументы

s	- строковый литерал.
...args	- параметры для инициализации аллокатора.

В этом случае просто запоминаем указатель на строку и её длину.

◆ sstring() [11/11]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename O>
requires (!std::is_same_v<O, K>)

simstr::sstring< K, Allocator >::sstring ( simple_str< O > init )

inline

Инициализация из строкового источника с другим типом символов. Конвертирует через UTF.

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

O	- тип жругих символов.

Методы

◆ as_int()

T simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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() [1/2]

void simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::as_number ( double & t ) const

inlineinherited

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

Аргументы

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

◆ as_number() [2/2]

void simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::as_number ( T & t ) const

inlineconstexprinherited

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

Так как as_number(double& t) перекрывает видимость as_number из базового класса, придётся добавить его ещё раз.

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

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

Аргументы

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

◆ at()

K simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::at ( ptrdiff_t idx ) const

inlineconstexprinherited

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

Аргументы

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

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

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

◆ c_str()

template<typename K, typename Impl>

const K * simstr::null_terminated< K, Impl >::c_str ( ) const

inlineconstexprinherited

Получить указатель на константный буфер символов строки

Возвращает: const K* - указатель на константный буфер символов строки

◆ compare()

int simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::compare ( str_piece o ) const

inlineconstexprinherited

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

Аргументы

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

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

◆ compare_ia()

int simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::compare_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ compare_iu()

int simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::compare_iu ( str_piece text ) const

inlinenoexceptinherited

Сравнение строк посимвольно без учёта регистра Unicode символов первой плоскости (<0xFFFF).

Аргументы

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

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

◆ contains()

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

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ copy_to()

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

inlineinherited

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

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

Аргументы

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

◆ ends_with()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::ends_with ( str_piece suffix ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ ends_with_ia()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::ends_with_ia ( str_piece suffix ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ ends_with_iu()

bool simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::ends_with_iu ( str_piece suffix ) const

inlineconstexprnoexceptinherited

Заканчивается ли строка указанной подстрокой без учёта регистра Unicode символов первой плоскости (<0xFFFF).

Аргументы

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

◆ equal()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::equal ( str_piece other ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ equal_ia()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::equal_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ equal_iu()

bool simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::equal_iu ( str_piece text ) const

inlinenoexceptinherited

Равна ли строка другой строке посимвольно без учёта регистра Unicode символов первой плоскости (<0xFFFF).

Аргументы

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

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

◆ find() [1/2]

size_t simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::find	(	str_piece	pattern,
		size_t	offset = 0 ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ find_all()

To simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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 - без ограничений.

◆ format()

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... T>

static my_type simstr::sstring< K, Allocator >::format	(	const FmtString< typename to_std_char_type< K >::type, T... > &	fmtString,
		T &&...	args )

inlinestatic

Получить строку, отформатированную с помощью std::format.

Аргументы

fmtString	- константная форматная строка.
...args	- аргументы для `std::format`.

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

◆ from_to()

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

inlineconstexprnoexceptinherited

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

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

Аргументы

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

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

◆ init_from_str_other()

void simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::init_from_str_other ( s_str other )

inlineconstexprprotectedinherited

Инициализация из другого строкового объекта.

Аргументы

other - другой строковый объект, simple_str.

◆ init_replaced()

void simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::init_replaced	(	const From &	f,
		s_str	pattern,
		s_str	repl,
		size_t	offset = 0,
		size_t	maxCount = 0 )

inlineprotectedinherited

Инициализация из строкового источника с заменой.

Аргументы

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

◆ init_str_expr()

void simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::init_str_expr ( const A & expr )

inlineconstexprprotectedinherited

Инициализация из строкового выражения.

Аргументы

expr	- строковое выражение.

Запрашивает у строкового выражения length(), выделяет память нужного размера, и вызывает метод place() для размещения результата в буфере.

◆ init_str_repeat()

void simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::init_str_repeat	(	size_t	repeat,
		s_str	pattern )

inlineconstexprprotectedinherited

Инициализация повторением строки.

Аргументы

repeat	- количество повторов.
pattern	- строка, которую надо повторить.

◆ init_symb_repeat()

void simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::init_symb_repeat	(	size_t	count,
		K	pad )

inlineconstexprprotectedinherited

Инициализация повторением символа.

Аргументы

count	- количество повторов.
pad	- символ, который надо повторить.

◆ join()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::join	(	const T &	strings,
		s_str	delimiter,
		bool	tail = false,
		bool	skip_empty = false,
		Args &&...	args )

inlinestaticinherited

Конкатенация строк из контейнера в одну строку.

Аргументы

strings	- контейнер со строками.
delimiter	- разделитель, добавляемый между строками.
tail	- добавить разделитель после последней строки.
skip_empty	- пропускать пустые строки без добавления разделителя.
...args	- параметры для инициализации аллокатора.

Функция служит для слияния контейнера строк в одну строку с разделителем.

std::vector<ssa> strings = get_strings();
ssa delim = get_current_delimiter();
auto line = lstringa<200>::join(strings, delimiter);

Стоит отметить, что при заранее известном разделителе лучше пользоваться строковым выражением e_join.

std::vector<ssa> strings = get_strings();

lstringa<200> line{e_join(strings, "/")};

simstr::e_join

constexpr auto e_join(const T &s, L &&d)

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

Определения strexpr.h:2035

В этом случае компилятор может лучше оптимизировать код слияния строк.

◆ less_ia()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::less_ia ( str_piece text ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ less_iu()

bool simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::less_iu ( str_piece text ) const

inlinenoexceptinherited

Меньше ли строка другой строки посимвольно без учёта регистра Unicode символов первой плоскости (<0xFFFF).

Аргументы

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

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

◆ lowered()

R simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::lowered ( ) const

inlineinherited

Получить копию строки в нижнем регистре Unicode символов первой плоскости (<0xFFFF).

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

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

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

◆ lowered_from()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::lowered_from	(	const From &	f,
		Args &&...	args )

inlinestaticinherited

Создать копию переданной строки в нижнем регистре символов Unicode первой плоскости (<0xFFFF).

Аргументы

f	- строка источник.
...args	- параметры для инициализации аллокатора.

Регистр меняется упрощенными таблицами, где один code_point всегда меняется в один code_point (но для UTF-8 возможно, что длина в code unit'ах изменится).

◆ lowered_only_ascii()

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::lowered_only_ascii ( ) const

inlineinherited

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

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

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

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

◆ lowered_only_ascii_from()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::lowered_only_ascii_from	(	const From &	f,
		Args &&...	args )

inlinestaticinherited

Создать копию переданной строки в нижнем регистре символов ASCII.

Аргументы

f	- строка источник.
...args	- параметры для инициализации аллокатора.

◆ make_empty()

template<typename K, Allocatorable Allocator = allocator_string>

my_type & simstr::sstring< K, Allocator >::make_empty ( )

inlineconstexprnoexcept

Сделать строку пустой.

Возвращает: my_type& - ссылку на себя же

◆ mid()

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

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ operator const K *()

simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::operator const K * ( ) const

inlineconstexprnoexceptinherited

Оператор преобразования в нуль-терминированную C-строку.

Возвращает: const K* - указатель на начало строки.

◆ operator s_str_nt()

simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::operator s_str_nt ( ) const

inlineconstexprinherited

Преобразовать в simple_str_nt.

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

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

simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::operator str_piece ( ) const

inlineconstexprnoexceptinherited

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

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

◆ operator()()

str_piece simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::operator<=> ( const base & other ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

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

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

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ operator=() [1/6]

template<typename K, Allocatorable Allocator = allocator_string>

template<size_t N, bool forShared, typename A>

my_type & simstr::sstring< K, Allocator >::operator= ( const lstring< K, N, forShared, A > & other )

inlineconstexpr

Оператор присвоения другой строки типа lstring.

Аргументы

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

Возвращает: my_type& - ссылку на себя же.

◆ operator=() [2/6]

template<typename K, Allocatorable Allocator = allocator_string>

my_type & simstr::sstring< K, Allocator >::operator= ( const StrExprForType< K > auto & expr )

inlineconstexpr

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

Аргументы

expr	- строковое выражения.

Возвращает: my_type& - ссылку на себя же.

В строковом выражение допустимо ссылаться на части этой же строки, так как сначала создаётся копия.

◆ operator=() [3/6]

template<typename K, Allocatorable Allocator = allocator_string>

template<size_t N>

my_type & simstr::sstring< K, Allocator >::operator= ( lstring< K, N, true, Allocator > && other )

inlineconstexpr

Оператор присвоения перемещаемой строки типа lstring с совместимым буфером.

Аргументы

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

Возвращает: my_type& - ссылку на себя же.

◆ operator=() [4/6]

template<typename K, Allocatorable Allocator = allocator_string>

my_type & simstr::sstring< K, Allocator >::operator= ( my_type other )

inlineconstexprnoexcept

Оператор присвоения другой строки того же типа.

Аргументы

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

Возвращает: my_type& - ссылку на себя же.

◆ operator=() [5/6]

template<typename K, Allocatorable Allocator = allocator_string>

my_type & simstr::sstring< K, Allocator >::operator= ( simple_str< K > other )

inlineconstexpr

Оператор присвоения другой строки другого типа.

Аргументы

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

Возвращает: my_type& - ссылку на себя же.

◆ operator=() [6/6]

template<typename K, Allocatorable Allocator = allocator_string>

template<typename T, size_t N = const_lit_for<K, T>::Count>

my_type & simstr::sstring< K, Allocator >::operator= ( T && other )

inlineconstexpr

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

Аргументы

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

Возвращает: my_type& - ссылку на себя же.

◆ operator==() [1/2]

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

inlineconstexprnoexceptinherited

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

Аргументы

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

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

◆ operator==() [2/2]

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

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ place()

K * simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::place ( K * ptr ) const

inlineconstexprnoexceptinherited

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

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

Аргументы

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

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

◆ prefix_in()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::prefix_in ( str_piece text ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ printf()

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... T>

static my_type simstr::sstring< K, Allocator >::printf	(	const K *	pattern,
		T &&...	args )

inlinestatic

Получить строку, отформатированную с помощью std::sprintf.

Аргументы

pattern	- форматная строка.
...args	- аргументы для `sprintf`.

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

Для Windows поддерживаются posix позиционные аргументы, используется _sprintf_p.

◆ replaced()

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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 строку заданного типа, по умолчанию того же, чей метод вызывался.

◆ replaced_from()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::replaced_from	(	const From &	f,
		s_str	pattern,
		s_str	repl,
		size_t	offset = 0,
		size_t	maxCount = 0,
		Args &&...	args )

inlinestaticinherited

Создать копию переданной строки с заменой подстрок.

Аргументы

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

◆ size()

size_t simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::size ( ) const

inlineconstexprinherited

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

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

◆ split()

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

inlineconstexprinherited

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

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

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

Аргументы

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

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

◆ splitf()

T simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::splitter ( str_piece delimiter ) const

inlineconstexprinherited

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

Аргументы

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

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

◆ starts_with()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::starts_with ( str_piece prefix ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ starts_with_ia()

bool simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::starts_with_ia ( str_piece prefix ) const

inlineconstexprnoexceptinherited

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

Аргументы

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

◆ starts_with_iu()

bool simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::starts_with_iu ( str_piece prefix ) const

inlinenoexceptinherited

Начинается ли строка с заданной подстроки без учёта регистра Unicode символов первой плоскости (<0xFFFF).

Аргументы

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

◆ str_mid()

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

inlineconstexprinherited

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

Аргументы

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

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

◆ strcmp()

int simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::strcmp ( const K * text ) const

inlineconstexprinherited

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

Аргументы

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

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

◆ substr()

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

inlineconstexprinherited

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

Аргументы

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

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

◆ to_double()

std::optional< double > simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::to_double ( ) const

inlinenoexceptinherited

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

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

◆ to_double_hex()

std::optional< double > simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::to_double_hex ( ) const

inlinenoexceptinherited

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

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

◆ to_int()

convert_result< T > simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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_nts()

s_str_nt simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::to_nts ( size_t from = 0 ) const

inlineconstexprinherited

Получить simple_str_nt, начиная с заданного символа.

Аргументы

from	- позиция начального символа, по умолчанию 0.

Возвращает: simple_str_nt,

◆ to_str()

str_piece simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::to_str ( ) const

inlineconstexprnoexceptinherited

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

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

◆ to_string()

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

inlineconstexprinherited

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

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

◆ to_sv()

std::basic_string_view< D > simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::to_sv ( ) const

inlineconstexprnoexceptinherited

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

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

◆ trimmed() [1/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed ( ) const

inlineconstexprinherited

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

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

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

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

◆ trimmed() [2/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed ( str_piece pattern ) const

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed() [3/3]

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

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_left() [1/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_left ( ) const

inlineinherited

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

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

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

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

◆ trimmed_left() [2/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_left ( str_piece pattern ) const

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_left() [3/3]

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

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_left_with_spaces() [1/2]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_left_with_spaces ( T && pattern ) const

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_right() [1/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_right ( ) const

inlineinherited

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

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

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

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

◆ trimmed_right() [2/3]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_right ( str_piece pattern ) const

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_right() [3/3]

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

inlineinherited

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

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

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

Аргументы

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

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

◆ trimmed_right_with_spaces() [1/2]

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, 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, simple_str< K >, sstring< K, allocator_string >, Mutable >::trimmed_with_spaces ( T && pattern ) const

inlineinherited

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

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

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

Аргументы

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

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

◆ upperred()

R simstr::str_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::upperred ( ) const

inlineinherited

Получить копию строки в верхнем регистре Unicode символов первой плоскости (<0xFFFF).

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

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

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

◆ upperred_from()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::upperred_from	(	const From &	f,
		Args &&...	args )

inlinestaticinherited

Создать копию переданной строки в верхнем регистре символов Unicode первой плоскости (<0xFFFF).

Аргументы

f	- строка источник.
...args	- параметры для инициализации аллокатора.

Регистр меняется упрощенными таблицами, где один code_point всегда меняется в один code_point (но для UTF-8 возможно, что длина в code unit'ах изменится).

◆ upperred_only_ascii()

R simstr::str_src_algs< K, simple_str< K >, sstring< K, allocator_string >, Mutable >::upperred_only_ascii ( ) const

inlineinherited

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

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

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

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

◆ upperred_only_ascii_from()

static my_type simstr::str_storable< K, sstring< K, allocator_string >, allocator_string >::upperred_only_ascii_from	(	const From &	f,
		Args &&...	args )

inlinestaticinherited

Создать строку, копию переданной в верхнем регистре символов ASCII.

Аргументы

f	- строка источник.
...args	- параметры для инициализации аллокатора.

◆ vformat()

template<typename K, Allocatorable Allocator = allocator_string>

template<typename... T>

static my_type simstr::sstring< K, Allocator >::vformat	(	simple_str< K >	fmtString,
		T &&...	args )

inlinestatic

Получить строку, отформатированную с помощью std::vformat.

Аргументы

fmtString	- форматная строка.
...args	- аргументы для `std::vformat`.

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

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

sstring.h

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

Открытые статические члены

Защищенные члены

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

Конструктор(ы)

◆ sstring() [1/11]

◆ sstring() [2/11]

◆ sstring() [3/11]

◆ sstring() [4/11]

◆ sstring() [5/11]

◆ sstring() [6/11]

◆ sstring() [7/11]

◆ sstring() [8/11]

◆ sstring() [9/11]

◆ sstring() [10/11]

◆ sstring() [11/11]

Методы

◆ as_int()

◆ as_number() [1/2]

◆ as_number() [2/2]

◆ at()

◆ c_str()

◆ compare()

◆ compare_ia()

◆ compare_iu()

◆ contains()

◆ copy_to()

◆ ends_with()

◆ ends_with_ia()

◆ ends_with_iu()

◆ equal()

◆ equal_ia()

◆ equal_iu()

◆ 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()

◆ format()

◆ from_to()

◆ init_from_str_other()

◆ init_replaced()

◆ init_str_expr()

◆ init_str_repeat()

◆ init_symb_repeat()

◆ join()

◆ less_ia()

◆ less_iu()

◆ lowered()

◆ lowered_from()

◆ lowered_only_ascii()

◆ lowered_only_ascii_from()

◆ make_empty()

◆ mid()

◆ operator const K *()

◆ operator s_str_nt()

◆ 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/6]

◆ operator=() [2/6]

◆ operator=() [3/6]