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() の使用例

この例では、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"
*/

関連情報


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]