Update page '2.6. vtype_string'

Gregory Lirent 2022-08-17 21:48:15 +03:00
parent 2a82fd7bf2
commit f65da818be

@ -117,21 +117,21 @@
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
- Принимает значение char/char16_t/char32_t, указатель на C-строку или указатель на область памяти, содержащую **vtype_string**, содержащее юникод символы, которые будут отсечены от строки.
- Удаляет юникод символы, содержащиеся в `arg` в начале и конце строки `x`.
- Удаляет юникод символы, содержащиеся в `arg`, в начале и конце строки `x`.
- `void string_ltrim(vtype_string* x, T arg)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
- Принимает значение char/char16_t/char32_t, указатель на C-строку или указатель на область памяти, содержащую **vtype_string**, содержащее юникод символы, которые будут отсечены от строки.
- Удаляет юникод символы, содержащиеся в `arg` в начале строки `x`.
- Удаляет юникод символы, содержащиеся в `arg`, в начале строки `x`.
- `void string_rtrim(vtype_string* x, T arg)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
- Принимает значение char/char16_t/char32_t, указатель на C-строку или указатель на область памяти, содержащую **vtype_string**, содержащее юникод символы, которые будут отсечены от строки.
- Удаляет юникод символы, содержащиеся в `arg` в конце строки `x`.
- Удаляет юникод символы, содержащиеся в `arg`, в конце строки `x`.
@ -141,51 +141,66 @@
- `size_t string_to_lower(vtype_string* x)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Переводит каждый юникод символ строки в нижний регистр.
- Возвращает количество юникод символов, переведенных в нижний регистр.
- `size_t string_to_upper(vtype_string* x)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Переводит каждый юникод символ строки в верхний регистр.
- Возвращает количество юникод символов, переведенных в верхний регистр.
- `size_t string_capitalize(vtype_string* x)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Переводит первый юникод символ строки в верхний регистр, а остальные - в нижний.
- Возвращает количество юникод символов, у которых был изменен регистр.
- `size_t string_reverse(vtype_string* x)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Переворачивает строку.
- Возвращает количество юникод символов в строке.
- `size_t string_align_center(vtype_string* x, size_t padsize, int padchr)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Принимает значение `padsize`, устанавливающее размер области (в количестве юникод символов), в рамках которой будет производиться выравнивание.
- Принимает значение char/char16_t/char32_t, устанавливающее символ, которым будет дополняться строка. Если задан некорректный юникод символ или использовано значение 0, будет использован обычный пробел.
- Производит центрирование значение строки `x`, в области, с размером `padsize`, дополняя значение строки `x` символом `padchr` слева и справа.
- Вовзращает итоговое количество юникод символов в строке.
- `size_t string_align_right(vtype_string* x, size_t padsize, int padchr)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Принимает значение `padsize`, устанавливающее размер области (в количестве юникод символов), в рамках которой будет производиться выравнивание.
- Принимает значение char/char16_t/char32_t, устанавливающее символ, которым будет дополняться строка. Если задан некорректный юникод символ или использовано значение 0, будет использован обычный пробел.
- Производит дополнение строки `x` символами `padchr` слева, до размера `padsize`
- Вовзращает итоговое количество юникод символов в строке.
- `size_t string_align_left(vtype_string* x, size_t padsize, int padchr)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Принимает значение `padsize`, устанавливающее размер области (в количестве юникод символов), в рамках которой будет производиться выравнивание.
- Принимает значение char/char16_t/char32_t, устанавливающее символ, которым будет дополняться строка. Если задан некорректный юникод символ или использовано значение 0, будет использован обычный пробел.
- Производит дополнение строки `x` символами `padchr` справа, до размера `padsize`
- Вовзращает итоговое количество юникод символов в строке.
- `void libcdsb_string_replace(vtype_string* x, char* dest, size_t dest_nmemb, const char* src, size_t nmemb)`
- Принимает указатель на область памяти, содержащую инициализированное значение **vtype_string** `x`.
-
- Принимает указатель `dest` на любой символ из области выделенной памяти в x->buffer
- Принимает размер заменяемой области памяти `dest_nmemb`
- Принимает указатель на последовательность символов, на которые будет производится замена `dest`
- Принимает размер заменяющей последовательности символов `nmemb`
- Производит замену `dest` с размером `dest_nmemb` на `src` с размером `nmemb`. Значение `dest` должно принадлежать выделенной памяти `x->buffer`, а выражение `dest + dest_nmemb` не должно указывать за пределы выделенной памяти. Подобную гарантию дает программист.
[Далее: 2.7. Дополнительно](https://gogs.lirent.ru/lirent/libcdsb/wiki/2.7.+%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE)