wcscmp() — ワイド文字ストリングの比較
フォーマット
#include <wchar.h>
int wcscmp(const wchar_t *string1, const wchar_t *string2);言語レベル
ANSI
スレッド・セーフ
はい
ワイド文字関数
詳細については、ワイド文字を参照してください。
説明
wcscmp() 関数は、2 つのワイド文字ストリングを比較します。wcscmp() 関数は、 ヌル終了 wchar_t ストリング上で作動します。この関数のストリング引数には、ストリングの終わりを示す wchar_t ヌル文字が入っていなければ なりません。ストリングを追加またはコピーするとき、境界検査は行われません。
戻り値
wcscmp() 関数は、2 つのストリング間の関係を示す次のような値を戻します。
| 値 | 意味 |
|---|---|
| 0 より小さい値 | string1 は string2 より小さい |
| 0 | string1 は string2 と等しい |
| 0 より大きい値 | string1 は string2 より大きい |
例
この例では、wcscmp() を使用して、ワイド文字ストリング string1 と string2 を比較します。
#include <stdio.h>
#include <wchar.h>
int main(void)
{
int result;
wchar_t string1[] = L"abcdef";
wchar_t string2[] = L"abcdefg";
result = wcscmp( string1, string2 );
if ( result == 0 )
printf( "¥"%ls¥" is identical to ¥"%ls¥"¥n", string1, string2);
else if ( result < 0 )
printf( "¥"%ls¥" is less than ¥"%ls¥"¥n", string1, string2 );
else
printf( "¥"%ls¥" is greater than ¥"%ls¥"¥n", string1, string2);
}
/**************** Output should be similar to: ******************
"abcdef" is less than "abcdefg"
*/