lstrcmpW

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

lstrcmpW lpString1, lpString2

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

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

解説

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

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

[備考]
lstrcmp は 2 つの文字列を 1 文字目同士、2
文字目同士のように比較し、不一致を見つけるか文字列末尾に達するまで続ける。lpString1 と lpString2 は NULL
終端でなければならず、さもなければ比較が誤る可能性がある。本関数は CompareStringEx を現在のスレッドロケールで呼び出し、C
ランタイムの文字列比較規約を維持するために結果から 2 を引く。セットアップ時または Control Panel で選択された言語
(ユーザーロケール) によりどの文字列が大きいかが決まる。ユーザーロケールが選択されていなければ既定値で比較する。DBCS
版システムでは本関数は 2 つの DBCS 文字列を比較できる。lstrcmp はワードソート (string sort ではなく)
を使う。ワードソートはハイフンやアポストロフィを他の非英数記号と異なる扱いにし、"coop" と "co-op"
のような単語をソート済みリスト内で隣接させる。詳細は Handling Sorting in Your Applications
を参照。比較関数選択に関するセキュリティ考察は Security Considerations: International
Features を参照。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs