strxfrmのヘルプ・マニュアル
日本語 英語
strxfrm --help
man strxfrm
STRXFRM(3) Linux Programmer’s Manual STRXFRM(3)
名前
strxfrm - 文字列の変換
書式
#include
size_t strxfrm(char *dest, const char *src, size_t n);
説明
strxfrm() 関数は文字列 src に対して、次の条件を満たすような変換をする:
「ある二つの文字列に対して、それぞれを strxfrm() で変換して か ら str-
cmp(3) した結果と、 strxfrm() による変換を行わずに strcoll(3) した結果
と同じ」変換した文字列の先頭から n 文字分が dest に代入される。変換は、
カ テゴリ LC_COLLATE に対する、プログラムの現在のロケールに基づいて行わ
れる (setlocale(3) を参照のこと)。
返り値
strxfrm() 関数は、変換された文字列を dest に代入するときに必要なバイ ト
数から、終端の '\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)
GNU 1993-04-12 STRXFRM(3)
STRXFRM(3) Linux Programmer’s Manual STRXFRM(3)
NAME
strxfrm - string transformation
SYNOPSIS
#include
size_t strxfrm(char *dest, const char *src, size_t n);
DESCRIPTION
The strxfrm() function transforms the src string into a form such that
the result of strcmp(3) on two strings that have been transformed with
strxfrm() is the same as the result of strcoll(3) on the two strings
before their transformation. The first n characters of the transformed
string are placed in dest. The transformation is based on the pro-
gram’s current locale for category LC_COLLATE. (See setlocale(3)).
RETURN VALUE
The strxfrm() function returns the number of bytes required to store
the transformed string in dest excluding the terminating '\0' charac-
ter. If the value returned is n or more, the contents of dest are
indeterminate.
CONFORMING TO
SVr4, 4.3BSD, C89, C99.
NOTES
In the "POSIX" or "C" locales strxfrm() is equivalent to copying the
string with strncpy(3).
SEE ALSO
bcmp(3), memcmp(3), setlocale(3), strcasecmp(3), strcmp(3), strcoll(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU 1993-04-12 STRXFRM(3)