1str.h(3)                   Library Functions Manual                   str.h(3)
2
3
4

NAME

6       str.h - Строки
7
8

SYNOPSIS

10       #include <string.h>
11       #include 'bee2/defs.h'
12
13
14   Макросы
15       #define strEq(str1,  str2)   (strCmp(str1, str2) == 0)
16
17   Функции
18       size_t strLen (const char *str)
19           Длина строки
20       size_t strLen2 (const char *str, size_t count)
21           Ограниченная длина строки
22       bool_t strIsValid (const char *str)
23           Корректная строка?
24       void strCopy (char *dest, const char *src)
25           Копирование строки
26       int strCmp (const char *str1, const char *str2)
27           Сравнение строк
28       void strSet (char *str, char ch)
29           Заполнение символом
30       bool_t strIsNumeric (const char *str)
31           Цифовая?
32       bool_t strIsAlphanumeric (const char *str)
33           Буквенно-цифовая?
34       bool_t strIsPrintable (const char *str)
35           Из печатаемых символов?
36       bool_t strStartsWith (const char *str, const char *prefix)
37           Начинается?
38       bool_t strEndsWith (const char *str, const char *suffix)
39           Заканчивается?
40       void strRev (char *str)
41           Разворот строки
42

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

44       Реализованы или переопределены манипуляции над строками. Строка
45       представляет собой последовательность символов-октетов, которая
46       заканчивается нулевым октетом.
47
48       Предусловие
49           Во все функции, кроме strIsValid(), передаются корректные строки.
50

Макросы

52   #define strEq(str1, str2)   (strCmp(str1, str2) == 0)
53       Проверяется совпадение строк str1 и str2.
54
55       Возвращает
56           Признак совпадения.
57
58       Регулярность
59           Функция нерегулярна.
60

Функции

62   int strCmp (const char * str1, const char * str2)
63       Строки str1 и str2 сравниваются лексикографически.
64
65       Возвращает
66           1, если str1 > str2, или -1, если str1 < str2, или 0, если str1 ==
67           str2.
68
69       Регулярность
70           Функция нерегулярна.
71
72       Аргументы
73           str1 первая строка
74           str2 вторая строка
75
76   void strCopy (char * dest, const char * src)
77       Строка src копируется в dest.
78
79       Предусловие
80           По адресу dest зарезервировано strLen(src) + 1 октетов.
81
82           Буферы src и dest не пересекаются.
83
84       Аргументы
85           dest строка-назначение
86           src строка-источник
87
88   bool_t strEndsWith (const char * str, const char * suffix)
89       Проверяется, что строка str заканчивается суффиксом suffix.
90
91       Возвращает
92           Признак успеха.
93
94       Регулярность
95           Функция нерегулярна.
96
97       Аргументы
98           str строка
99           suffix суффикс
100
101   bool_t strIsAlphanumeric (const char * str)
102       Проверяется, что строка str состоит только из символов-цифр '0'-'9' и
103       символов букв 'A'-'Z', 'a'-'z'.
104
105       Возвращает
106           Признак успеха.
107
108       Регулярность
109           Функция нерегулярна.
110
111       Аргументы
112           str строка
113
114   bool_t strIsNumeric (const char * str)
115       Проверяется, что строка str состоит только из символов-цифр '0'-'9'.
116
117       Возвращает
118           Признак успеха.
119
120       Регулярность
121           Функция нерегулярна.
122
123       Аргументы
124           str строка
125
126   bool_t strIsPrintable (const char * str)
127       Проверяется, что каждый символ строки str принадлежит алфавиту,
128       составленному из латинских букв, цифр и символов строки ' '()+,-./:=?'.
129
130       Возвращает
131           Признак успеха.
132
133       Регулярность
134           Функция нерегулярна.
135
136       Прим.
137           Целевой алфавит -- это алфавит PrintableString АСН.1.
138
139       Аргументы
140           str строка
141
142   bool_t strIsValid (const char * str)
143       Проверяется, что строка str корректна.
144
145       Возвращает
146           Признак успеха.
147
148       Аргументы
149           str строка
150
151   size_t strLen (const char * str)
152       Определяется длина строки str -- число символов до завершающего
153       нулевого.
154
155       Возвращает
156           Длина строки
157
158   size_t strLen2 (const char * str, size_t count)
159       Определяется длина строки str в пределах окна из count первых символов.
160
161       Возвращает
162           MIN2(strLen(str), count).
163
164   void strRev (char * str)
165       Символы строки str переписываются в обратном порядке.
166
167       Аргументы
168           str строка
169
170   void strSet (char * str, char ch)
171       Строка str заполняется символом ch.
172
173       Аргументы
174           str строка
175           ch символ
176
177   bool_t strStartsWith (const char * str, const char * prefix)
178       Проверяется, что строка str начинается с префикca prefix.
179
180       Возвращает
181           Признак успеха.
182
183       Регулярность
184           Функция нерегулярна.
185
186       Аргументы
187           str строка
188           prefix префикс
189

Автор

191       Автоматически создано Doxygen для Библиотека Bee2 из исходного текста.
192
193
194
195Библиотека Bee2                 Пт 23 Июн 2023                        str.h(3)