StrIsIntlEqualW 関数 (shlwapi.h)

2 つの文字列の先頭から指定した文字数を比較して、それらが等しいかどうかを判断します。

構文

BOOL StrIsIntlEqualW(
       BOOL   fCaseSens,
  [in] PCWSTR pszString1,
  [in] PCWSTR pszString2,
       int    nChar
);

パラメーター

fCaseSens

種類: BOOL

比較の大文字と小文字の区別。 この値が 0 以外の場合、比較では大文字と小文字が区別されます。 この値が 0 の場合、比較では大文字と小文字は区別されません。

[in] pszString1

種類: PCTSTR

比較する最初の null で終わる文字列へのポインター。

[in] pszString2

種類: PCTSTR

比較する 2 番目の null で終わる文字列へのポインター。

nChar

型: int

比較する各文字列の先頭からの文字数。

戻り値

種類: BOOL

2 つの文字列の最初の nChar 文字が等しい場合は TRUE。それ以外の場合は FALSE。

解説

大文字と小文字の区別は 、StrIntlEqN マクロと StrIntlEqNI マクロで 設定できます。 StrIntlEqN は 大文字と小文字を区別する比較を実行し、 StrIntlEqNI は大文字と小文字を区別しない比較を実行します。

2 つのマクロの構文は次のとおりです。

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

注意

shlwapi.h ヘッダーは、STRIsIntlEqual をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 4.71 以降)