lstrcmpiW

2 つの文字列を比較する。比較は大文字小文字を区別しない。(Unicode)

lstrcmpiW lpString1, lpString2

lpString1 : [wstr] 型: LPCTSTR 比較する 1 番目の NULL 終端文字列。
lpString2 : [wstr] 型: LPCTSTR 比較する 2 番目の NULL 終端文字列。

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

解説

2 つの文字列を比較する。比較は大文字小文字を区別しない。(Unicode)

[戻り値]
型: int lpString1 が指す文字列が lpString2 より小さい場合、戻り値は負。大きい場合は正。等しい場合は 0。

[備考]
lstrcmpi は 2 つの文字列を 1 文字目同士、2
文字目同士のように比較し、不一致を見つけるか文字列末尾に達するまで続ける。lpString1 と lpString2 は NULL
終端でなければならず、さもなければ比較が誤る可能性がある。本関数は CompareStringEx
を現在のスレッドロケールで呼び出し、結果から 2 を引く。一部のロケールでは lstrcmpi では不十分なことがある。その場合は
CompareStringEx を使い適切な比較を行う。たとえば日本では
NORM_IGNORECASE、NORM_IGNOREKANATYPE、NORM_IGNOREWIDTH
を指定するとよい。NORM_IGNOREKANATYPE と NORM_IGNOREWIDTH
はアジア以外のロケールでは無視されるので、すべてのロケールで設定して文化的に正しい不感ソートを保証できる。ただしこれらは性能を低下させるので必要時のみ使う。DBCS
版システムでは本関数は 2 つの DBCS 文字列を比較できる。lstrcmpi はワードソートを使う。

情報