strxfrm - преобразование строки
strxfrm(3)
преобразование строки
ОБЗОР
#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 не определено.
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
strxfrm()
безвредность в потоках: безвредно (MT-Safe locale)
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.
ЗАМЕЧАНИЯ
В локалях
POSIX или
C выполнение функции
strxfrm() эквивалентно
копированию строки с помощью
strncpy(3).
