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).