#Requires

バージョン要件が満たされない場合、エラーを表示し終了します。

#Requires Requirement

パラメータ

Requirement

これが "AutoHotkey"で始まらない場合、エラーメッセージが表示され、プログラムは終了します。これにより、指令の明確化が促進され、将来の使用のために指令が確保されます。AutoHotkeyの他のフォークでは、他の名称をサポートしている場合があります。

それ以外の場合は、"AutoHotkey"という単語の後に、スペースまたはタブで区切られた以下の任意の組み合わせが続く必要があります。

エラーメッセージ

表示されるメッセージは、ディレクティブを解釈しているAutoHotkeyのバージョンに依存します。

v2の場合、エラーメッセージにAutoHotkeyのパス、バージョン、ビルドが必ず表示されます。

このディレクティブをサポートしていないバージョンのAutoHotkeyでスクリプトを起動した場合、以下のようなエラーメッセージが表示されます。

ラインテキスト:#Requires %Requirement%
エラー:この行には、認識された動作は含まれていません。

備考

スクリプトが以前のバージョンでは利用できない構文や関数を使用している場合、このディレクティブを使用すると、エラーメッセージが任意の構文エラーを示すのではなく、満たされていない要件を示すことを保証します。これは、if (A_AhkVersion <= "1.1.33")のように、スクリプト内の他の場所で構文エラーが発生すると実行できなくなるため、実行できません。

スクリプトを共有したり、コードをオンラインに投稿する場合、このディレクティブを使用すると、コードを見つけた人が、どのバージョンのAutoHotkeyを対象としているかを容易に特定することができます。

他のプログラムやスクリプトは、さまざまな目的でこのディレクティブを確認することができます。例えば、AutoHotkey v2と共にインストールされたランチャーは、どのAutoHotkey実行ファイルを起動するかを決定するために使用し、スクリプトエディターや関連ツールは、スクリプトファイルの解釈やハイライトの方法を決定するために使用するかもしれません。

バージョン文字列は、ドットで区切られた一連のコンポーネントとして比較され、オプションでハイフンとプレリリース識別子が続く。

末尾の "+"は、後のバージョンでもよいことを読者に示すのに十分ですが、必須ではありません。

他のディレクティブと同様に、#Requiresは条件付きで実行することはできません。

VerCompare, #ErrorStdOut

アルファ版を含むv2.0上でのみスクリプトを実行するようにするためのものです。

#Requires AutoHotkey v2.0-a
MsgBox "This script will run only on v2.0, including alpha releases."

プレリリースバージョンを含むv2.0上でのみスクリプトを実行するようにします。

#Requires AutoHotkey >=2.0- <2.1

64ビットインタプリタ(EXE)のみでスクリプトを実行するようにします。

#Requires AutoHotkey 64-bit

64ビットインタプリタ(EXE)バージョン2.0-rc.2以降でのみスクリプトを実行するようにすることです。

#Requires AutoHotkey v2.0-rc.2 64-bit