manページ  — STRXFRM

strxfrm – 文字列をロケールにしたがって変換する

ライブラリ 書式 解説 戻り値 関連項目 規格

Standard C Library (libc, -lc)

#include <string.h>

strxfrm(char *dst, const char *src, size_t n);

strxfrm() 関数は、 src により示されたヌル文字で終了する文字列を、 現在のロケール照合 (locale collation) がある場合には、 それに従って変換し、 変換した文字列を dst にコピーします。 n を越えない文字数が dst にヌル文字を付加してコピーされます。 もし n に 0 がセットされた場合 (この場合変換に必要となる実サイズを決定するのを助けます)、 dst には NULL ポインタにする事が許されます。

strxfrm() の後で strcmp() を使って 2 つの文字列を比較することは、 元の 2 つの文字列を strcoll() を使って比較することと同じになります。

完全に成功した場合、 strxfrm() は終端のヌル文字を含まない変換された文字列の長さを返します。 もしこの値が n と同じかそれより大きい場合、 dst の内容は不定です。

strxfrm() 関数は、 ISO/IEC 9899:1990 ("ISO C90") に適合しています。