aorefkov
/
simstr
mirror of https://github.com/orefkov/simstr.git
0
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Change docs

This commit is contained in:
Aleksandr Orefkov 2026-02-22 11:13:06 +03:00
parent 75c9d52f0d
commit f798e8fbbb
2 changed files with 84 additions and 84 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

100
include/simstr/sstring.h
View File

@ -224,7 +224,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше. * @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.
* @en @brief Compare strings character by character without taking into account the case of Unicode characters of the first plane (<0xFFFF). * @en @brief Compare strings character by character without taking into account the case of Unicode characters of the first plane (<0xFFFF).
* @param text - another line. * @param text - another string.
* @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater. * @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater.
*/ */
int compare_iu(str_piece text) const noexcept { // NOLINT int compare_iu(str_piece text) const noexcept { // NOLINT
@ -235,7 +235,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return равны ли строки. * @return равны ли строки.
* @en @brief Whether a string is equal to another string, character-by-character-insensitive, of the Unicode characters of the first plane (<0xFFFF). * @en @brief Whether a string is equal to another string, character-by-character-insensitive, of the Unicode characters of the first plane (<0xFFFF).
* @param text - another line. * @param text - another string.
* @return whether the strings are equal. * @return whether the strings are equal.
*/ */
bool equal_iu(str_piece text) const noexcept { // NOLINT bool equal_iu(str_piece text) const noexcept { // NOLINT
@ -246,7 +246,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return меньше ли строка. * @return меньше ли строка.
* @en @brief Whether a string is smaller than another string, character-by-character-insensitive, of the Unicode characters of the first plane (<0xFFFF). * @en @brief Whether a string is smaller than another string, character-by-character-insensitive, of the Unicode characters of the first plane (<0xFFFF).
* @param text - another line. * @param text - another string.
* @return whether the string is smaller. * @return whether the string is smaller.
*/ */
bool less_iu(str_piece text) const noexcept { // NOLINT bool less_iu(str_piece text) const noexcept { // NOLINT
@ -484,7 +484,7 @@ struct simple_str : str_algs<K, simple_str<K>, simple_str<K>, false> {
* @ru @brief Сдвигает начало строки на заданное количество символов. * @ru @brief Сдвигает начало строки на заданное количество символов.
* @param delta - количество символов. * @param delta - количество символов.
* @return my_type&. * @return my_type&.
* @en @brief Shifts the start of a line by the specified number of characters. * @en @brief Shifts the start of a string by the specified number of characters.
* @param delta - number of characters. * @param delta - number of characters.
* @return my_type&. * @return my_type&.
*/ */
@ -593,7 +593,7 @@ struct simple_str_nt : simple_str<K>, null_terminated<K, simple_str_nt<K>> {
* @param from - на сколько символов сдвинуть начало строки. * @param from - на сколько символов сдвинуть начало строки.
* @return my_type. * @return my_type.
* @en @brief Get a null-terminated string by shifting the start by the specified number of characters. * @en @brief Get a null-terminated string by shifting the start by the specified number of characters.
* @param from - by how many characters to shift the beginning of the line. * @param from - by how many characters to shift the beginning of the string.
* @return my_type. * @return my_type.
*/ */
constexpr my_type to_nts(size_t from) { constexpr my_type to_nts(size_t from) {
@ -816,11 +816,11 @@ concept immutable_str = storable_str<A, K> && !mutable_str<A, K>;
* is being created and no data sharing has yet taken place. * is being created and no data sharing has yet taken place.
* *
* These methods must be implemented by the descendant class and are called only when an object is created * These methods must be implemented by the descendant class and are called only when an object is created
* - `K* init(size_t size)` - allocate space for a line of the specified size, return the address * - `K* init(size_t size)` - allocate space for a string of the specified size, return the address
* - `void create_empty()` - create an empty object * - `void create_empty()` - create an empty object
* - `K* set_size(size_t size)` - re-allocate space for the line if you didn’t guess correctly when creating * - `K* set_size(size_t size)` - re-allocate space for the string if you didn’t guess correctly when creating
* the size you need and the space you need is larger or smaller. * the size you need and the space you need is larger or smaller.
* The contents of the line must be left. * The contents of the string must be left.
* Although the allocator type is specified by the template parameter, this is done only for forwarding * Although the allocator type is specified by the template parameter, this is done only for forwarding
* of its type in constructors, allocator methods are not called. If the heir does not use * of its type in constructors, allocator methods are not called. If the heir does not use
* an allocator, and in `init` and `set_size` it somehow allocates space, can indicate the type of the allocator * an allocator, and in `init` and `set_size` it somehow allocates space, can indicate the type of the allocator
@ -885,7 +885,7 @@ protected:
* @param pattern - строка, которую надо повторить. * @param pattern - строка, которую надо повторить.
* @en @brief String repetition initialization. * @en @brief String repetition initialization.
* @param repeat - number of repetitions. * @param repeat - number of repetitions.
* @param pattern - the line to be repeated. * @param pattern - the string to be repeated.
*/ */
constexpr void init_str_repeat(size_t repeat, s_str pattern) { constexpr void init_str_repeat(size_t repeat, s_str pattern) {
size_t l = pattern.length(), allLen = l * repeat; size_t l = pattern.length(), allLen = l * repeat;
@ -995,10 +995,10 @@ protected:
if (len) { if (len) {
const K* source = f.symbols(); const K* source = f.symbols();
K* destination = result.init(len); K* destination = result.init(len);
for (size_t l = 0; l < len; l++) { while(len--) {
destination[l] = opMakeNeedCase(source[l]); *destination++ = opMakeNeedCase(*source++);
} }
destination[len] = 0; *destination = 0;
} }
return result; return result;
} }
@ -1042,7 +1042,7 @@ protected:
result.set_size(newLen); result.set_size(newLen);
} else if (newLen > len) { } else if (newLen > len) {
// Строка не влезла в буфер. // Строка не влезла в буфер.
// The line did not fit into the buffer. // The string did not fit into the buffer.
size_t readed = static_cast<size_t>(source - ptr); size_t readed = static_cast<size_t>(source - ptr);
size_t writed = static_cast<size_t>(dest - pWrite); size_t writed = static_cast<size_t>(dest - pWrite);
pWrite = result.set_size(newLen); pWrite = result.set_size(newLen);
@ -1062,7 +1062,7 @@ public:
* @ru @brief Оператор преобразования в нуль-терминированную C-строку. * @ru @brief Оператор преобразования в нуль-терминированную C-строку.
* @return const K* - указатель на начало строки. * @return const K* - указатель на начало строки.
* @en @brief Conversion operator to a null-terminated C string. * @en @brief Conversion operator to a null-terminated C string.
* @return const K* - pointer to the beginning of the line. * @return const K* - pointer to the beginning of the string.
*/ */
constexpr operator const K*() const noexcept { constexpr operator const K*() const noexcept {
return d().symbols(); return d().symbols();
@ -1113,7 +1113,7 @@ public:
* @en @brief Concatenate strings from the container into one string. * @en @brief Concatenate strings from the container into one string.
* @param strings - container with strings. * @param strings - container with strings.
* @param delimiter - delimiter added between lines. * @param delimiter - delimiter added between lines.
* @param tail - add a separator after the last line. * @param tail - add a separator after the last string.
* @param skip_empty - skip empty lines without adding a separator. * @param skip_empty - skip empty lines without adding a separator.
* @param ...args - parameters for initializing the allocator. * @param ...args - parameters for initializing the allocator.
* @details The function is used to merge a container of strings into one delimited string. * @details The function is used to merge a container of strings into one delimited string.
@ -1342,7 +1342,7 @@ inline size_t grow2(size_t ret, size_t currentCapacity) {
* - `bool is_empty() const noexcept` - checks whether the string is empty * - `bool is_empty() const noexcept` - checks whether the string is empty
* - `K* str() noexcept` - Non-const pointer to the beginning of the string * - `K* str() noexcept` - Non-const pointer to the beginning of the string
* - `K* set_size(size_t size)` - Change the size of the string, either larger or smaller. * - `K* set_size(size_t size)` - Change the size of the string, either larger or smaller.
* The contents of the line must be left. * The contents of the string must be left.
* - `K* reserve_no_preserve(size_t size)` - allocate space for a line, you don’t have to save the old one * - `K* reserve_no_preserve(size_t size)` - allocate space for a line, you don’t have to save the old one
* - `K* alloc_for_copy(size_t size)` - allocate space for a copy of a string of a given size, without changing it yet * - `K* alloc_for_copy(size_t size)` - allocate space for a copy of a string of a given size, without changing it yet
* the string itself, you can return the current buffer if space allows. * the string itself, you can return the current buffer if space allows.
@ -1421,7 +1421,7 @@ private:
d().set_size(newLen); d().set_size(newLen);
} else if (newLen > len) { } else if (newLen > len) {
// Строка не влезла в буфер. // Строка не влезла в буфер.
// The line did not fit into the buffer. // The string did not fit into the buffer.
size_t readed = static_cast<size_t>(readPos - startData); size_t readed = static_cast<size_t>(readPos - startData);
size_t writed = static_cast<size_t>(writePos - startData); size_t writed = static_cast<size_t>(writePos - startData);
d().set_size(newLen); d().set_size(newLen);
@ -1475,7 +1475,7 @@ public:
/*! /*!
* @ru @brief Удалить пробельные символы в начале и в конце строки. * @ru @brief Удалить пробельные символы в начале и в конце строки.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove whitespace from the beginning and end of a line. * @en @brief Remove whitespace from the beginning and end of a string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
Impl& trim() { Impl& trim() {
@ -1484,7 +1484,7 @@ public:
/*! /*!
* @ru @brief Удалить пробельные символы в начале строки. * @ru @brief Удалить пробельные символы в начале строки.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove whitespace at the beginning of a line. * @en @brief Remove whitespace at the beginning of a string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
Impl& trim_left() { Impl& trim_left() {
@ -1493,7 +1493,7 @@ public:
/*! /*!
* @ru @brief Удалить пробельные символы в конце строки. * @ru @brief Удалить пробельные символы в конце строки.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove whitespace from the end of a line. * @en @brief Remove whitespace from the end of a string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
Impl& trim_right() { Impl& trim_right() {
@ -1503,7 +1503,7 @@ public:
* @ru @brief Удалить символы, входящие в строковый литерал, в начале и в конце строки. * @ru @brief Удалить символы, входящие в строковый литерал, в начале и в конце строки.
* @param pattern - строковый литерал, содержащий символы, которые надо удалить. * @param pattern - строковый литерал, содержащий символы, которые надо удалить.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove characters included in a string literal at the beginning and end of the line. * @en @brief Remove characters included in a string literal at the beginning and end of the string.
* @param pattern is a string literal containing the characters to be removed. * @param pattern is a string literal containing the characters to be removed.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1516,7 +1516,7 @@ public:
* @ru @brief Удалить символы, входящие в строковый литерал, в начале строки. * @ru @brief Удалить символы, входящие в строковый литерал, в начале строки.
* @param pattern - строковый литерал, содержащий символы, которые надо удалить. * @param pattern - строковый литерал, содержащий символы, которые надо удалить.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove characters included in a string literal at the beginning of the line. * @en @brief Remove characters included in a string literal at the beginning of the string.
* @param pattern is a string literal containing the characters to be removed. * @param pattern is a string literal containing the characters to be removed.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1529,7 +1529,7 @@ public:
* @ru @brief Удалить символы, входящие в строковый литерал, в конце строки. * @ru @brief Удалить символы, входящие в строковый литерал, в конце строки.
* @param pattern - строковый литерал, содержащий символы, которые надо удалить. * @param pattern - строковый литерал, содержащий символы, которые надо удалить.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove characters included in a string literal at the end of the line. * @en @brief Remove characters included in a string literal at the end of the string.
* @param pattern is a string literal containing the characters to be removed. * @param pattern is a string literal containing the characters to be removed.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1555,7 +1555,7 @@ public:
* @ru @brief Удалить символы, входящие в строковый литерал, а также пробельные символы, в начале строки. * @ru @brief Удалить символы, входящие в строковый литерал, а также пробельные символы, в начале строки.
* @param pattern - строковый литерал, содержащий символы, которые надо удалить. * @param pattern - строковый литерал, содержащий символы, которые надо удалить.
* @return Impl& - ссылку на себя же * @return Impl& - ссылку на себя же
* @en @brief Remove characters included in a string literal, as well as whitespace, at the beginning of a line. * @en @brief Remove characters included in a string literal, as well as whitespace, at the beginning of a string.
* @param pattern is a string literal containing the characters to be removed. * @param pattern is a string literal containing the characters to be removed.
* @en @brief* @return Impl& - a reference to yourself. * @en @brief* @return Impl& - a reference to yourself.
*/ */
@ -1581,7 +1581,7 @@ public:
* @ru @brief Удалить символы, входящие в переданную строку, в начале и в конце строки. * @ru @brief Удалить символы, входящие в переданную строку, в начале и в конце строки.
* @param pattern - строка, содержащая символы, которые надо удалить. * @param pattern - строка, содержащая символы, которые надо удалить.
* @return Impl& - ссылку на себя же * @return Impl& - ссылку на себя же
* @en @brief Remove characters included in the passed string at the beginning and end of the line. * @en @brief Remove characters included in the passed string at the beginning and end of the string.
* @param pattern - a string containing the characters to be removed. * @param pattern - a string containing the characters to be removed.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1592,7 +1592,7 @@ public:
* @ru @brief Удалить символы, входящие в переданную строку, в начале строки. * @ru @brief Удалить символы, входящие в переданную строку, в начале строки.
* @param pattern - строка, содержащая символы, которые надо удалить. * @param pattern - строка, содержащая символы, которые надо удалить.
* @return Impl& - ссылку на себя же * @return Impl& - ссылку на себя же
* @en @brief Remove characters included in the passed string at the beginning of the line. * @en @brief Remove characters included in the passed string at the beginning of the string.
* @param pattern - a string containing the characters to be removed. * @param pattern - a string containing the characters to be removed.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1759,7 +1759,7 @@ public:
* @ru @brief Добавить другую строку в конец строки. * @ru @brief Добавить другую строку в конец строки.
* @param other - другая строка. * @param other - другая строка.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add another line to the end of the line. * @en @brief Add another string to the end of the string.
* @param other - another string. * @param other - another string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1770,7 +1770,7 @@ public:
* @ru @brief Добавить строковое выражение в конец строки. * @ru @brief Добавить строковое выражение в конец строки.
* @param expr - строковое выражение. * @param expr - строковое выражение.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add a string expression to the end of the line. * @en @brief Add a string expression to the end of the string.
* @param expr - string expression. * @param expr - string expression.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1782,8 +1782,8 @@ public:
* @ru @brief Добавить другую строку в конец строки. * @ru @brief Добавить другую строку в конец строки.
* @param other - другая строка. * @param other - другая строка.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add another line to the end of the line. * @en @brief Add another string to the end of the string.
* @param other - another line. * @param other - another string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
Impl& operator+=(str_piece other) { Impl& operator+=(str_piece other) {
@ -1793,7 +1793,7 @@ public:
* @ru @brief Добавить строковое выражение в конец строки. * @ru @brief Добавить строковое выражение в конец строки.
* @param expr - строковое выражение. * @param expr - строковое выражение.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add a string expression to the end of the line. * @en @brief Add a string expression to the end of the string.
* @param expr - string expression. * @param expr - string expression.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1808,9 +1808,9 @@ public:
* @param other - другая строка. * @param other - другая строка.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @details Если строка длиинее`pos`, то она укорачивается до этого размера, а потом добавляется `other`. * @details Если строка длиинее`pos`, то она укорачивается до этого размера, а потом добавляется `other`.
* @en @brief Add another line starting at the given position. * @en @brief Add another string starting at the given position.
* @param pos - the position from which to add. First, the string is shortened to the specified value * @param pos - the position from which to add. First, the string is shortened to the specified value
* size, and then another line is added. * size, and then another string is added.
* @param other - another string. * @param other - another string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
* @details If the string is longer than `pos`, then it is shortened to this size, and then `other` is added. * @details If the string is longer than `pos`, then it is shortened to this size, and then `other` is added.
@ -1872,7 +1872,7 @@ public:
* @param to - позиция для вставки. * @param to - позиция для вставки.
* @param other - вставляемая строка. * @param other - вставляемая строка.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Insert a line at the specified position. * @en @brief Insert a string at the specified position.
* @param to - insertion position. * @param to - insertion position.
* @param other - the string to be inserted. * @param other - the string to be inserted.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
@ -1899,7 +1899,7 @@ public:
* @param from - позиция, с которой удалить. * @param from - позиция, с которой удалить.
* @param len - длина удаляемой части. * @param len - длина удаляемой части.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Remove part of a line. * @en @brief Remove part of a string.
* @param from - the position from which to delete. * @param from - the position from which to delete.
* @param len - length of the part to be deleted. * @param len - length of the part to be deleted.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
@ -1911,7 +1911,7 @@ public:
* @ru @brief Добавить другую строку в начало строки. * @ru @brief Добавить другую строку в начало строки.
* @param other - другая строка. * @param other - другая строка.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add another line to the beginning of the line. * @en @brief Add another string to the beginning of the string.
* @param other - another string. * @param other - another string.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -1922,7 +1922,7 @@ public:
* @ru @brief Добавить строковое выражение в начало строки. * @ru @brief Добавить строковое выражение в начало строки.
* @param expr - строковое выражение. * @param expr - строковое выражение.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @en @brief Add a string expression to the beginning of a line. * @en @brief Add a string expression to the beginning of a string.
* @param expr - string expression. * @param expr - string expression.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
*/ */
@ -2121,7 +2121,7 @@ public:
* As long as the returned size is larger than capacity (i.e. the string cannot fit into the buffer), * As long as the returned size is larger than capacity (i.e. the string cannot fit into the buffer),
* memory of at least the returned size is allocated and the functor is called again. * memory of at least the returned size is allocated and the functor is called again.
* Until the returned size fits into the string buffer. * Until the returned size fits into the string buffer.
* This size becomes the length of the line. * This size becomes the length of the string.
*/ */
template<typename Op> template<typename Op>
Impl& fill(size_t from, const Op& fillFunction) { Impl& fill(size_t from, const Op& fillFunction) {
@ -2260,7 +2260,7 @@ public:
* @param ...args - аргументы для sprintf. * @param ...args - аргументы для sprintf.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @details При необходимости автоматически увеличивает размер буфера строки. * @details При необходимости автоматически увеличивает размер буфера строки.
* @en @brief Appends sprintf formatted output to the end of the line. * @en @brief Appends sprintf formatted output to the end of the string.
* @param format - format string. * @param format - format string.
* @param ...args - arguments for sprintf. * @param ...args - arguments for sprintf.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
@ -2398,7 +2398,7 @@ public:
* @param ...args - аргументы для std::format. * @param ...args - аргументы для std::format.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @details При необходимости автоматически увеличивает размер буфера строки. * @details При необходимости автоматически увеличивает размер буфера строки.
* @en @brief Appends std::format-formatted output to the end of the line. * @en @brief Appends std::format-formatted output to the end of the string.
* @param format - format string, constant. * @param format - format string, constant.
* @param ...args - arguments for std::format. * @param ...args - arguments for std::format.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
@ -2430,7 +2430,7 @@ public:
* @param ... - аргументы для std::vformat. * @param ... - аргументы для std::vformat.
* @return Impl& - ссылку на себя же. * @return Impl& - ссылку на себя же.
* @details При необходимости автоматически увеличивает размер буфера строки. * @details При необходимости автоматически увеличивает размер буфера строки.
* @en @brief Appends std::vformat-formatted output to the end of the line. * @en @brief Appends std::vformat-formatted output to the end of the string.
* @param format - format string. * @param format - format string.
* @param ... - arguments for std::vformat. * @param ... - arguments for std::vformat.
* @return Impl& - a reference to yourself. * @return Impl& - a reference to yourself.
@ -2730,7 +2730,7 @@ public:
* @param ...args - параметры для инициализации аллокатора. * @param ...args - параметры для инициализации аллокатора.
* @en @brief String repetition constructor. * @en @brief String repetition constructor.
* @param repeat - number of repetitions. * @param repeat - number of repetitions.
* @param pattern - the line to be repeated. * @param pattern - the string to be repeated.
* @param ...args - parameters for initializing the allocator. * @param ...args - parameters for initializing the allocator.
*/ */
template<typename... Args> template<typename... Args>
@ -3125,7 +3125,7 @@ public:
* @ru @brief Определить длину строки. * @ru @brief Определить длину строки.
* Ищет символ 0 в буфере строки до его ёмкости, после чего устаналивает длину строки по найденному 0. * Ищет символ 0 в буфере строки до его ёмкости, после чего устаналивает длину строки по найденному 0.
* @en @brief Determine the length of the string. * @en @brief Determine the length of the string.
* Searches for the character 0 in the string buffer to its capacity, and then sets the length of the line to the found 0. * Searches for the character 0 in the string buffer to its capacity, and then sets the length of the string to the found 0.
*/ */
constexpr void define_size() { constexpr void define_size() {
size_t cap = capacity(); size_t cap = capacity();
@ -3301,11 +3301,11 @@ protected:
// возможное место, то localRemain становится 0, type в этом случае тоже 0, // возможное место, то localRemain становится 0, type в этом случае тоже 0,
// и в итоге после символов строки получается 0, как и надо! // и в итоге после символов строки получается 0, как и надо!
// When we have a short string, it lies in the object itself, and in localRemain // When we have a short string, it lies in the object itself, and in localRemain
// writes how many more characters can be entered. When a line takes up everything // writes how many more characters can be entered. When a string takes up everything
// possible location, then localRemain becomes 0, type in this case is also 0, // possible location, then localRemain becomes 0, type in this case is also 0,
// and as a result, after the characters of the line we get 0, as it should! // and as a result, after the characters of the string we get 0, as it should!
struct { struct {
K buf_[LocalCount]; // Локальный буфер строки | Local line buffer K buf_[LocalCount]; // Локальный буфер строки | Local string buffer
uns_type localRemain_ : sizeof(uns_type) * CHAR_BIT - 2; uns_type localRemain_ : sizeof(uns_type) * CHAR_BIT - 2;
uns_type type_ : 2; uns_type type_ : 2;
}; };
@ -3422,7 +3422,7 @@ public:
* @param ...args - параметры для инициализации аллокатора. * @param ...args - параметры для инициализации аллокатора.
* @en @brief String repetition constructor. * @en @brief String repetition constructor.
* @param repeat - number of repetitions. * @param repeat - number of repetitions.
* @param pattern - the line to be repeated. * @param pattern - the string to be repeated.
* @param ...args - parameters for initializing the allocator. * @param ...args - parameters for initializing the allocator.
*/ */
template<typename... Args> template<typename... Args>
@ -3693,7 +3693,7 @@ public:
constexpr const K* symbols() const noexcept { constexpr const K* symbols() const noexcept {
return type_ == Local ? buf_ : cstr_; return type_ == Local ? buf_ : cstr_;
} }
/// @ru Длина строки. @en Line length. /// @ru Длина строки. @en string length.
constexpr size_t length() const noexcept { constexpr size_t length() const noexcept {
return type_ == Local ? LocalCount - localRemain_ : bigLen_; return type_ == Local ? LocalCount - localRemain_ : bigLen_;
} }
@ -3843,7 +3843,7 @@ public:
* @param pattern - строка, которую надо повторить. * @param pattern - строка, которую надо повторить.
* @en @brief String repetition constructor. * @en @brief String repetition constructor.
* @param repeat - number of repetitions. * @param repeat - number of repetitions.
* @param pattern - the line to be repeated. * @param pattern - the string to be repeated.
*/ */
constexpr cestring(size_t repeat, s_str pattern) : base_storable() { constexpr cestring(size_t repeat, s_str pattern) : base_storable() {
base_storable::init_str_repeat(repeat, pattern); base_storable::init_str_repeat(repeat, pattern);
@ -4361,7 +4361,7 @@ struct str_eqliu {
* Сам является строковым выражением. * Сам является строковым выражением.
* @en @brief For constructing long dynamic strings by concatenating small pieces. * @en @brief For constructing long dynamic strings by concatenating small pieces.
* @details Selects individual blocks of a given size (or a multiple of it for large inserts) as needed. * @details Selects individual blocks of a given size (or a multiple of it for large inserts) as needed.
* to avoid relocation of long strings. After construction, you can merge it into one line. * to avoid relocation of long strings. After construction, you can merge it into one string.
* As measurements have shown, if you then merge it into one line, it works slower than lstring +=, * As measurements have shown, if you then merge it into one line, it works slower than lstring +=,
* but more economical in memory. If you don't merge it into one line, and then iterate through buffers, it's faster. * but more economical in memory. If you don't merge it into one line, and then iterate through buffers, it's faster.
* Itself is a string expression. * Itself is a string expression.

68
include/simstr/strexpr.h
View File

@ -2795,7 +2795,7 @@ struct expr_join : expr_to_std_string<expr_join<K, T, I, tail, skip_empty>> {
* @param s - контейнер со строками, должен поддерживать `range for`. * @param s - контейнер со строками, должен поддерживать `range for`.
* @param d - разделитель, строковый литерал. * @param d - разделитель, строковый литерал.
* @en @brief Get a string expression concatenating the strings in the container into a single string with the given delimiter.limiter.limiter. * @en @brief Get a string expression concatenating the strings in the container into a single string with the given delimiter.limiter.limiter.
* @tparam tail - whether to add a separator after the last line. * @tparam tail - whether to add a separator after the last string.
* @tparam skip_empty - skip empty lines without adding a separator. * @tparam skip_empty - skip empty lines without adding a separator.
* @param s - container with strings, must support `range for`. * @param s - container with strings, must support `range for`.
* @param d - delimiter, string literal. * @param d - delimiter, string literal.
@ -3143,7 +3143,7 @@ public:
* @ru @brief Указатель на константный символ после после последнего символа строки. * @ru @brief Указатель на константный символ после после последнего символа строки.
* @return const K* - конец строки. * @return const K* - конец строки.
* @en @brief Pointer to a constant character after the last character of the string. * @en @brief Pointer to a constant character after the last character of the string.
* @return const K* - end of line. * @return const K* - end of string.
*/ */
constexpr const K* end() const { return d().symbols() + d().length(); } constexpr const K* end() const { return d().symbols() + d().length(); }
/*! /*!
@ -3157,7 +3157,7 @@ public:
* @ru @brief Указатель на константный символ после после последнего символа строки. * @ru @brief Указатель на константный символ после после последнего символа строки.
* @return const K* - конец строки. * @return const K* - конец строки.
* @en @brief Pointer to a constant character after the last character of the string. * @en @brief Pointer to a constant character after the last character of the string.
* @return const K* - end of line. * @return const K* - end of string.
*/ */
constexpr const K* cend() const { return d().symbols() + d().length(); } constexpr const K* cend() const { return d().symbols() + d().length(); }
}; };
@ -3185,7 +3185,7 @@ public:
* @ru @brief Указатель на константный символ после после последнего символа строки. * @ru @brief Указатель на константный символ после после последнего символа строки.
* @return const K* - конец строки. * @return const K* - конец строки.
* @en @brief Pointer to a constant character after the last character of the string. * @en @brief Pointer to a constant character after the last character of the string.
* @return const K* - end of line. * @return const K* - end of string.
*/ */
constexpr const K* end() const { return base::end(); } constexpr const K* end() const { return base::end(); }
/*! /*!
@ -3199,7 +3199,7 @@ public:
* @ru @brief Указатель на константный символ после после последнего символа строки. * @ru @brief Указатель на константный символ после после последнего символа строки.
* @return const K* - конец строки. * @return const K* - конец строки.
* @en @brief Pointer to a constant character after the last character of the string. * @en @brief Pointer to a constant character after the last character of the string.
* @return const K* - end of line. * @return const K* - end of string.
*/ */
constexpr const K* cend() const { return base::cend(); } constexpr const K* cend() const { return base::cend(); }
/*! /*!
@ -3220,7 +3220,7 @@ public:
* @ru @brief Указатель на символ после после последнего символа строки. * @ru @brief Указатель на символ после после последнего символа строки.
* @return K* - конец строки. * @return K* - конец строки.
* @en @brief Pointer to the character after the last character of the string. * @en @brief Pointer to the character after the last character of the string.
* @return K* - end of line. * @return K* - end of string.
*/ */
constexpr K* end() { return d().str() + d().length(); } constexpr K* end() { return d().str() + d().length(); }
}; };
@ -3293,7 +3293,7 @@ public:
* only with a pointer to a string and its length. * only with a pointer to a string and its length.
* To work, the descendant class must implement the following methods: * To work, the descendant class must implement the following methods:
* - size_t length() const noexcept - returns the length of the string. * - size_t length() const noexcept - returns the length of the string.
* - const K* symbols() const noexcept - returns a pointer to the beginning of the line. * - const K* symbols() const noexcept - returns a pointer to the beginning of the string.
* - bool is_empty() const noexcept - checks whether the string is empty. * - bool is_empty() const noexcept - checks whether the string is empty.
* @tparam K - character type. * @tparam K - character type.
* @tparam StrRef - storage type for the string chunk. * @tparam StrRef - storage type for the string chunk.
@ -3431,10 +3431,10 @@ public:
* @details Если `from` меньше нуля, то отсчитывается `-from` символов от конца строки в сторону начала. * @details Если `from` меньше нуля, то отсчитывается `-from` символов от конца строки в сторону начала.
* Если `len` меньше или равно нулю, то отсчитать `-len` символов от конца строки * Если `len` меньше или равно нулю, то отсчитать `-len` символов от конца строки
* @en @brief Get part of a string as "str_src". * @en @brief Get part of a string as "str_src".
* @param from - number of characters from the beginning of the line. * @param from - number of characters from the beginning of the string.
* @param len - the number of characters in the resulting "chunk". * @param len - the number of characters in the resulting "chunk".
* @return Substring, str_src. * @return Substring, str_src.
* @details If `from` is less than zero, then `-from` characters are counted from the end of the line towards the beginning. * @details If `from` is less than zero, then `-from` characters are counted from the end of the string towards the beginning.
* If `len` is less than or equal to zero, then count `-len` characters from the end of the line * If `len` is less than or equal to zero, then count `-len` characters from the end of the line
* @~ * @~
* ```cpp * ```cpp
@ -3461,8 +3461,8 @@ public:
* @param len - количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки. * @param len - количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки.
* @return Подстроку, str_src. * @return Подстроку, str_src.
* @en @brief Get part of a string as "string chunk". * @en @brief Get part of a string as "string chunk".
* @param from - number of characters from the beginning of the line. If the string size is exceeded, it will return an empty string. * @param from - number of characters from the beginning of the string. If the string size is exceeded, it will return an empty string.
* @param len - the number of characters in the resulting "chunk". When going beyond the line, it will return everything up to the end of the line. * @param len - the number of characters in the resulting "chunk". When going beyond the line, it will return everything up to the end of the string.
* @return Substring, str_src. * @return Substring, str_src.
*/ */
constexpr str_piece mid(size_t from, size_t len = -1) const noexcept { constexpr str_piece mid(size_t from, size_t len = -1) const noexcept {
@ -3481,8 +3481,8 @@ public:
* @param to - конечная позиция (не входит в результат). * @param to - конечная позиция (не входит в результат).
* @return Подстроку, str_src. * @return Подстроку, str_src.
* @en @brief Get the substring str_src from position from to position to (not including it). * @en @brief Get the substring str_src from position from to position to (not including it).
* @details For performance reasons, the method does not check for line boundaries in any way, use * @details For performance reasons, the method does not check for string boundaries in any way, use
* in scenarios when you know for sure that these are positions inside the line and to >= from. * in scenarios when you know for sure that these are positions inside the string and to >= from.
* @param from - starting position. * @param from - starting position.
* @param to - final position (not included in the result). * @param to - final position (not included in the result).
* @return Substring, str_src. * @return Substring, str_src.
@ -3516,9 +3516,9 @@ public:
* @return K - символ. * @return K - символ.
* @details Не производит проверку на выход за границы строки. * @details Не производит проверку на выход за границы строки.
* @en @brief Get the character at the given position. * @en @brief Get the character at the given position.
* @param idx - symbol index. For negative values, it is counted from the end of the line. * @param idx - symbol index. For negative values, it is counted from the end of the string.
* @return K - character. * @return K - character.
* @details Does not check for line boundaries. * @details Does not check for string boundaries.
*/ */
constexpr K at(ptrdiff_t idx) const { constexpr K at(ptrdiff_t idx) const {
return _str()[idx >= 0 ? idx : _len() + idx]; return _str()[idx >= 0 ? idx : _len() + idx];
@ -3535,7 +3535,7 @@ public:
* @param o - другая строка. * @param o - другая строка.
* @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше. * @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.
* @en @brief Compare strings character by character. * @en @brief Compare strings character by character.
* @param o - another line. * @param o - another string.
* @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater. * @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater.
*/ */
constexpr int compare(str_piece o) const { constexpr int compare(str_piece o) const {
@ -3546,7 +3546,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше. * @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.
* @en @brief Compare with C-string character by character. * @en @brief Compare with C-string character by character.
* @param text - another line. * @param text - another string.
* @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater. * @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater.
*/ */
constexpr int strcmp(const K* text) const { constexpr int strcmp(const K* text) const {
@ -3575,7 +3575,7 @@ public:
* @param other - другая строка. * @param other - другая строка.
* @return равны ли строки. * @return равны ли строки.
* @en @brief String comparison for equality. * @en @brief String comparison for equality.
* @param other - another line. * @param other - another string.
* @return whether the strings are equal. * @return whether the strings are equal.
*/ */
constexpr bool equal(str_piece other) const noexcept { constexpr bool equal(str_piece other) const noexcept {
@ -3586,7 +3586,7 @@ public:
* @param other - другая строка. * @param other - другая строка.
* @return равны ли строки. * @return равны ли строки.
* @en @brief Operator comparing strings for equality. * @en @brief Operator comparing strings for equality.
* @param other - another line. * @param other - another string.
* @return whether the strings are equal. * @return whether the strings are equal.
*/ */
constexpr bool operator==(const base& other) const noexcept { constexpr bool operator==(const base& other) const noexcept {
@ -3596,7 +3596,7 @@ public:
* @ru @brief Оператор сравнения строк. * @ru @brief Оператор сравнения строк.
* @param other - другая строка. * @param other - другая строка.
* @en @brief String comparison operator. * @en @brief String comparison operator.
* @param other - another line. * @param other - another string.
*/ */
constexpr auto operator<=>(const base& other) const noexcept { constexpr auto operator<=>(const base& other) const noexcept {
return compare(other._str(), other._len()) <=> 0; return compare(other._str(), other._len()) <=> 0;
@ -3650,7 +3650,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше. * @return <0 эта строка меньше, ==0 - строки равны, >0 - эта строка больше.
* @en @brief Compare strings character by character and not case sensitive ASCII characters. * @en @brief Compare strings character by character and not case sensitive ASCII characters.
* @param text - another line. * @param text - another string.
* @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater. * @return <0 this string is less, ==0 - strings are equal, >0 - this string is greater.
*/ */
constexpr int compare_ia(str_piece text) const noexcept { // NOLINT constexpr int compare_ia(str_piece text) const noexcept { // NOLINT
@ -3662,7 +3662,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return равны ли строки. * @return равны ли строки.
* @en @brief Whether a string is equal to another string, character-by-character-insensitive, of ASCII characters. * @en @brief Whether a string is equal to another string, character-by-character-insensitive, of ASCII characters.
* @param text - another line. * @param text - another string.
* @return whether the strings are equal. * @return whether the strings are equal.
*/ */
constexpr bool equal_ia(str_piece text) const noexcept { // NOLINT constexpr bool equal_ia(str_piece text) const noexcept { // NOLINT
@ -3673,7 +3673,7 @@ public:
* @param text - другая строка. * @param text - другая строка.
* @return меньше ли строка. * @return меньше ли строка.
* @en @brief Whether a string is smaller than another string, character-by-character-insensitive, ASCII characters. * @en @brief Whether a string is smaller than another string, character-by-character-insensitive, ASCII characters.
* @param text - another line. * @param text - another string.
* @return whether the string is smaller. * @return whether the string is smaller.
*/ */
constexpr bool less_ia(str_piece text) const noexcept { // NOLINT constexpr bool less_ia(str_piece text) const noexcept { // NOLINT
@ -3683,7 +3683,7 @@ public:
constexpr size_t find(const K* pattern, size_t lenPattern, size_t offset) const noexcept { constexpr size_t find(const K* pattern, size_t lenPattern, size_t offset) const noexcept {
size_t lenText = _len(); size_t lenText = _len();
// Образец, не вмещающийся в строку и пустой образец не находим // Образец, не вмещающийся в строку и пустой образец не находим
// We don't look for an empty line or a line longer than the text. // We don't look for an empty string or a string longer than the text.
if (!lenPattern || offset >= lenText || offset + lenPattern > lenText) if (!lenPattern || offset >= lenText || offset + lenPattern > lenText)
return str::npos; return str::npos;
lenPattern--; lenPattern--;
@ -3781,7 +3781,7 @@ public:
return find_last(pattern[0], offset); return find_last(pattern[0], offset);
size_t lenText = std::min(_len(), offset); size_t lenText = std::min(_len(), offset);
// Образец, не вмещающийся в строку и пустой образец не находим // Образец, не вмещающийся в строку и пустой образец не находим
// We don't look for an empty line or a line longer than the text. // We don't look for an empty string or a string longer than the text.
if (!lenPattern || lenPattern > lenText) if (!lenPattern || lenPattern > lenText)
return str::npos; return str::npos;
@ -4068,8 +4068,8 @@ public:
* @param len - количество символов в получаемом "куске". Если меньше или равно нулю, то отсчитать len символов от конца строки. * @param len - количество символов в получаемом "куске". Если меньше или равно нулю, то отсчитать len символов от конца строки.
* @return my_type - подстроку, объект того же типа, к которому применён метод. * @return my_type - подстроку, объект того же типа, к которому применён метод.
* @en @brief Get a substring. Works similarly to operator(), only the result is the same type as the method applied to. * @en @brief Get a substring. Works similarly to operator(), only the result is the same type as the method applied to.
* @param from - number of characters from the beginning of the line. If less than zero, it is counted from the end of the line towards the beginning. * @param from - number of characters from the beginning of the string. If less than zero, it is counted from the end of the string towards the beginning.
* @param len - the number of characters in the resulting "chunk". If less than or equal to zero, then count len ​​characters from the end of the line. * @param len - the number of characters in the resulting "chunk". If less than or equal to zero, then count len ​​characters from the end of the string.
* @return my_type - a substring, an object of the same type to which the method is applied. * @return my_type - a substring, an object of the same type to which the method is applied.
*/ */
constexpr my_type substr(ptrdiff_t from, ptrdiff_t len = 0) const { // индексация в code units | indexing in code units constexpr my_type substr(ptrdiff_t from, ptrdiff_t len = 0) const { // индексация в code units | indexing in code units
@ -4081,8 +4081,8 @@ public:
* @param len - количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки. * @param len - количество символов в получаемом "куске". При выходе за пределы строки вернёт всё до конца строки.
* @return Строку того же типа, к которому применён метод. * @return Строку того же типа, к которому применён метод.
* @en @brief Get part of a string with an object of the same type to which the method is applied, similar to mid. * @en @brief Get part of a string with an object of the same type to which the method is applied, similar to mid.
* @param from - number of characters from the beginning of the line. If the string size is exceeded, it will return an empty string. * @param from - number of characters from the beginning of the string. If the string size is exceeded, it will return an empty string.
* @param len - the number of characters in the resulting "chunk". When going beyond the line, it will return everything up to the end of the line. * @param len - the number of characters in the resulting "chunk". When going beyond the line, it will return everything up to the end of the string.
* @return A string of the same type to which the method is applied. * @return A string of the same type to which the method is applied.
*/ */
constexpr my_type str_mid(size_t from, size_t len = -1) const { // индексация в code units | indexing in code units constexpr my_type str_mid(size_t from, size_t len = -1) const { // индексация в code units | indexing in code units
@ -4112,7 +4112,7 @@ public:
* - 0[bB]: 2 * - 0[bB]: 2
* - 0[xX]: 16 * - 0[xX]: 16
* - in other cases 10. * - in other cases 10.
* @tparam SkipWs - skip whitespace characters at the beginning of the line. * @tparam SkipWs - skip whitespace characters at the beginning of the string.
* @tparam AllowSign - whether the '+' sign is allowed before a number. * @tparam AllowSign - whether the '+' sign is allowed before a number.
* @return T - a number, the result of the transformation, how much it turned out, or 0 if it overflows. * @return T - a number, the result of the transformation, how much it turned out, or 0 if it overflows.
*/ */
@ -4145,7 +4145,7 @@ public:
* - 0[bB]: 2 * - 0[bB]: 2
* - 0[xX]: 16 * - 0[xX]: 16
* - in other cases 10. * - in other cases 10.
* @tparam SkipWs - skip whitespace characters at the beginning of the line. All characters with ASCII codes <= 32 are skipped. * @tparam SkipWs - skip whitespace characters at the beginning of the string. All characters with ASCII codes <= 32 are skipped.
* @tparam AllowSign - whether the '+' sign is allowed before a number. * @tparam AllowSign - whether the '+' sign is allowed before a number.
* @return convert_result<T> - a tuple of the received number, the success of the conversion and the number of characters processed. * @return convert_result<T> - a tuple of the received number, the success of the conversion and the number of characters processed.
*/ */
@ -4916,7 +4916,7 @@ struct str_src : str_src_algs<K, str_src<K>, str_src<K>, false> {
* @ru @brief Сдвигает начало строки на заданное количество символов. * @ru @brief Сдвигает начало строки на заданное количество символов.
* @param delta - количество символов. * @param delta - количество символов.
* @return my_type&. * @return my_type&.
* @en @brief Shifts the start of a line by the specified number of characters. * @en @brief Shifts the start of a string by the specified number of characters.
* @param delta - number of characters. * @param delta - number of characters.
* @return my_type&. * @return my_type&.
*/ */
@ -5022,7 +5022,7 @@ struct str_src_nt : str_src<K>, null_terminated<K, str_src_nt<K>> {
* @param from - на сколько символов сдвинуть начало строки. * @param from - на сколько символов сдвинуть начало строки.
* @return my_type. * @return my_type.
* @en @brief Get a null-terminated string by shifting the start by the specified number of characters. * @en @brief Get a null-terminated string by shifting the start by the specified number of characters.
* @param from - by how many characters to shift the beginning of the line. * @param from - by how many characters to shift the beginning of the string.
* @return my_type. * @return my_type.
*/ */
constexpr my_type to_nts(size_t from) { constexpr my_type to_nts(size_t from) {
@ -7010,7 +7010,7 @@ struct replace_grow_helper {
total_length = end_of_piece + all_delta; total_length = end_of_piece + all_delta;
my_type* dst_str{}; my_type* dst_str{};
if (total_length <= str.capacity()) { if (total_length <= str.capacity()) {
// Строка поместится в старое место | The line will be placed in the old location. // Строка поместится в старое место | The string will be placed in the old location.
dst_str = &str; dst_str = &str;
} else { } else {
// Будем создавать в другом буфере | We will create in another buffer. // Будем создавать в другом буфере | We will create in another buffer.