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() 関数は現在のローケル照合順序に従って、ヌル文字で終了する文字列
s1 と
s2 を比較します。“
C
”ロケールでは、
wcscoll() は
wcscmp() と同等です。
戻り値
wcscoll() 関数は、
s1 が
s2 よりも大きいか、等しいか、または小さいなら、 0 よりも大きい、等しい、または小さい整数を返します。
リターン値はエラーを示せません。呼び出し側は wcscoll() を呼び出す前、 errno を 0 を設定するべきです。 wcscoll() からの返ったときに、それが 0 でなければ、エラーが発生しました。
エラー
wcscoll() 関数は、次の場合に失敗します:
-
[
EILSEQ]
-
無効のワイド文字コードが指定されました。
-
[
ENOMEM]
-
一時的なバッファのための十分なメモリを割り付けることができません。
規格
wcscoll() 関数は、 ISO/IEC 9899:1999 (“ISO C99”) に適合しています。
バグ
wcscoll() の現在の実装は、単一のバイト
LC_CTYPE ロケールだけで動作し、拡張文字セットのローケルでは
wcscmp() を使用して代替しています。