str.h - Man Page

Строки

Synopsis

#include <string.h>
#include 'bee2/defs.h'

Макросы

#define strEq(str1,  str2)   (strCmp(str1, str2) == 0)

Функции

size_t strLen (const char *str)
Длина строки
size_t strLen2 (const char *str, size_t count)
Ограниченная длина строки
bool_t strIsValid (const char *str)
Корректная строка?
void strCopy (char *dest, const char *src)
Копирование строки
int strCmp (const char *str1, const char *str2)
Сравнение строк
void strSet (char *str, char ch)
Заполнение символом
bool_t strIsNumeric (const char *str)
Цифовая?
bool_t strIsAlphanumeric (const char *str)
Буквенно-цифовая?
bool_t strIsPrintable (const char *str)
Из печатаемых символов?
bool_t strStartsWith (const char *str, const char *prefix)
Начинается?
bool_t strEndsWith (const char *str, const char *suffix)
Заканчивается?
void strRev (char *str)
Разворот строки

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

Реализованы или переопределены манипуляции над строками. Строка представляет собой последовательность символов-октетов, которая заканчивается нулевым октетом.

Предусловие

Во все функции, кроме strIsValid(), передаются корректные строки.

Макросы

#define strEq(str1, str2)   (strCmp(str1, str2) == 0)

Проверяется совпадение строк str1 и str2.

Возвращает

Признак совпадения.

Регулярность

Функция нерегулярна.

Функции

int strCmp (const char * str1, const char * str2)

Строки str1 и str2 сравниваются лексикографически.

Возвращает

1, если str1 > str2, или -1, если str1 < str2, или 0, если str1 == str2.

Регулярность

Функция нерегулярна.

Аргументы

str1 первая строка  
str2 вторая строка

void strCopy (char * dest, const char * src)

Строка src копируется в dest.

Предусловие

По адресу dest зарезервировано strLen(src) + 1 октетов.

Буферы src и dest не пересекаются.

Аргументы

dest строка-назначение  
src строка-источник

bool_t strEndsWith (const char * str, const char * suffix)

Проверяется, что строка str заканчивается суффиксом suffix.

Возвращает

Признак успеха.

Регулярность

Функция нерегулярна.

Аргументы

str строка  
suffix суффикс

bool_t strIsAlphanumeric (const char * str)

Проверяется, что строка str состоит только из символов-цифр '0'-'9' и символов букв 'A'-'Z', 'a'-'z'.

Возвращает

Признак успеха.

Регулярность

Функция нерегулярна.

Аргументы

str строка

bool_t strIsNumeric (const char * str)

Проверяется, что строка str состоит только из символов-цифр '0'-'9'.

Возвращает

Признак успеха.

Регулярность

Функция нерегулярна.

Аргументы

str строка

bool_t strIsPrintable (const char * str)

Проверяется, что каждый символ строки str принадлежит алфавиту, составленному из латинских букв, цифр и символов строки ' '()+,-./:=?'.

Возвращает

Признак успеха.

Регулярность

Функция нерегулярна.

Прим.

Целевой алфавит -- это алфавит PrintableString АСН.1.

Аргументы

str строка

bool_t strIsValid (const char * str)

Проверяется, что строка str корректна.

Возвращает

Признак успеха.

Аргументы

str строка

size_t strLen (const char * str)

Определяется длина строки str -- число символов до завершающего нулевого.

Возвращает

Длина строки

size_t strLen2 (const char * str, size_t count)

Определяется длина строки str в пределах окна из count первых символов.

Возвращает

MIN2(strLen(str), count).

void strRev (char * str)

Символы строки str переписываются в обратном порядке.

Аргументы

str строка

void strSet (char * str, char ch)

Строка str заполняется символом ch.

Аргументы

str строка  
ch символ

bool_t strStartsWith (const char * str, const char * prefix)

Проверяется, что строка str начинается с префикca prefix.

Возвращает

Признак успеха.

Регулярность

Функция нерегулярна.

Аргументы

str строка  
prefix префикс

Автор

Автоматически создано Doxygen для Библиотека Bee2 из исходного текста.

Info

Вт 23 Янв 2024 00:00:00 Библиотека Bee2