名前 | 形式 | 機能説明 | 戻り値 | エラー | 使用法 | 属性 | 関連項目
#include <wchar.h>int wcscoll(const wchar_t *ws1, const wchar_t *ws2);
wcscoll() と wscoll() の両関数は、ws1 と ws2 が示す 2 つのワイド文字列を比較します。両文字列は、現ロケールの LC_COLLATE カテゴリに従って解釈されます。
比較処理が正常に終了すると、wcscoll() および wscoll() はその結果を示す値を返します。現ロケールに従って比較した結果、両文字列が一致していれば 0 を、ws1 が指す文字列の方が ws2 が指す文字列より大きければ 0 より大きい値を、小さければ 0 より小さい値をそれぞれ返します。エラーが発生した場合、wcscoll() および wscoll() は errno を設定することがありますが、エラー発生を表す戻り値は定義されていません。
wcscoll() および wscoll() 関数は、以下の状態のときエラーを返します。
引数 ws1 または ws2 が示すワイド文字列に、照合手順に定義されていない ワイド文字コードが含まれていた
関数はサポートされていない
エラーを示す戻り値は定義されていないため、エラー発生の有無を知りたいアプリケーションは、errno を 0 に設定して wcscoll() または wscoll() を呼び出し、処理実行後に errno の値を調べる必要があります。値が 0 以外であれば、エラーが起こったものと判断できます。
大量のデータを分類するときは、wcsxfrm(3C) および wcscmp(3C) 関数を使用してください。
wcscoll() と wscoll() 関数は、setlocale(3C) を呼び出してロケールを変更しない限り、マルチスレッドのアプリケーションで安全に使用できます。
次の属性については attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
MT レベル | 例外付き MT-safe |
CSI | 対応済み |