From f65da818bee1a925be61fe10a77b9c861ab0ba20 Mon Sep 17 00:00:00 2001 From: Gregory Lirent Date: Wed, 17 Aug 2022 21:48:15 +0300 Subject: [PATCH] Update page '2.6. vtype_string' --- 2.6. vtype_string.md | 41 ++++++++++++++++++++++++++++------------- 1 file changed, 28 insertions(+), 13 deletions(-) diff --git a/2.6. vtype_string.md b/2.6. vtype_string.md index 565495b..5cac83a 100644 --- a/2.6. vtype_string.md +++ b/2.6. vtype_string.md @@ -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) \ No newline at end of file