StrCmpNIA

2 つの文字列の先頭から指定した文字数を比較し、同一であるかどうかを判定する。比較では大文字と小文字を区別しない。StrNCmpI マクロはこの関数と名称が異なるだけである。(ANSI)

StrCmpNIA psz1, psz2, nChar

psz1 : [str] 型: PCTSTR 比較する 1 つ目の NULL 終端文字列へのポインタ。
psz2 : [str] 型: PCTSTR 比較する 2 つ目の NULL 終端文字列へのポインタ。
nChar : [int] 型: int 各文字列の先頭から比較する文字数。

(プラグイン / モジュール : shlwapi.dll)

解説

2 つの文字列の先頭から指定した文字数を比較し、同一であるかどうかを判定する。比較では大文字と小文字を区別しない。StrNCmpI
マクロはこの関数と名称が異なるだけである。(ANSI)

[戻り値]
型: int 文字列が等しい場合はゼロを返す。psz1 が指す文字列の先頭 nChar 文字が psz2
が指す文字列のそれより大きい場合は正の値を返す。psz1 が指す文字列の先頭 nChar 文字が psz2
が指す文字列のそれより小さい場合は負の値を返す。

[備考]
> [!NOTE] > shlwapi.h ヘッダーは StrCmpNI をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に応じて、この関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じることがある。詳細については
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報