table of contents
STRXFRM(3) | Руководство программиста Linux | STRXFRM(3) |
ИМЯ¶
strxfrm - преобразование строки
ОБЗОР¶
#include <string.h> size_t strxfrm(char *dest, const char *src, size_t n);
ОПИСАНИЕ¶
Функция strxfrm() преобразует строку src в такую форму, что выполнение strcmp(3) над двумя такими строками, преобразованными посредством strxfrm(), будет таким же, как и выполнение strcoll(3) над строками до преобразования. Первые n байт преобразованной строки помещаются в dest. Преобразование основывается на настройках категории текущей локали LC_COLLATE программы (смотрите setlocale(3)).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
Функция strxfrm() возвращает количество байт, необходимое для размещения преобразованной строки в dest без завершающего байта null («\0»). Если возвращённое значение равно n или больше этой величины, то содержимое dest не определено.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
SVr4, 4.3BSD, C89, C99.
ЗАМЕЧАНИЯ¶
В локалях «POSIX» или «C» выполнение функции strxfrm() эквивалентно копированию строки с помощью strncpy(3).
СМОТРИТЕ ТАКЖЕ¶
bcmp(3), memcmp(3), setlocale(3), strcasecmp(3), strcmp(3), strcoll(3), string(3)
2012-05-10 | GNU |