Scroll to navigation

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