EN JA
WCSCOLL(3)
WCSCOLL(3) FreeBSD Library Functions Manual WCSCOLL(3)

名称

wcscoll現在の照合に従ってワイソ文字列を比較する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < wchar.h>

int
wcscoll( const wchar_t *s1, const wchar_t *s2);

解説

wcscoll() 関数は現在のローケル照合順序に従って、ヌル文字で終了する文字列 s1s2 を比較します。“ C”ロケールでは、 wcscoll() は wcscmp() と同等です。

戻り値

wcscoll() 関数は、 s1s2 よりも大きいか、等しいか、または小さいなら、 0 よりも大きい、等しい、または小さい整数を返します。

リターン値はエラーを示せません。呼び出し側は wcscoll() を呼び出す前、 errno を 0 を設定するべきです。 wcscoll() からの返ったときに、それが 0 でなければ、エラーが発生しました。

エラー

wcscoll() 関数は、次の場合に失敗します:
[ EILSEQ]
無効のワイド文字コードが指定されました。
[ ENOMEM]
一時的なバッファのための十分なメモリを割り付けることができません。

規格

wcscoll() 関数は、 ISO/IEC 9899:1999 (“ISO C99”) に適合しています。

バグ

wcscoll() の現在の実装は、単一のバイト LC_CTYPE ロケールだけで動作し、拡張文字セットのローケルでは wcscmp() を使用して代替しています。
October 4, 2002 FreeBSD