Qt Creator 変数の使用

Preferences,Build Settings,Run Settings の引数、実行パス、作業ディレクトリを設定するフィールドなどでQt Creator 変数を使用することができます。変数は展開の引用符で囲むので、引用符で囲む必要はありません。

フィールドで (Variables) ボタンを選択すると、特定のコンテキストで使用可能な変数のリストから選択できます。各変数の詳細については、リストでその変数の上にカーソルを移動してください。

次の構文を使うと、環境変数をQt Creator 変数として使うことができます： %{Env:VARNAME}。

パターン置換

Qt Creator は、変数名を展開するときにパターン置換を使用します。変数内のパターンの最初のマッチを置換で置き換えるには、 %{v:VARNAME} を使用します：

%{variable/pattern/replacement}

変数内のすべてのパターンを 置換するには、次のようにします：

%{variable//pattern/replacement}

パターンは正規表現で、置換は後方参照を持つことができます。たとえば、%{variable} がmy123var の場合、%{variable/(..)(\d+)/\2\1} は123myvar に展開されます。

フォワード・スラッシュの代わりに、数字記号（# ）を置換文字として使うこともできます。これは、値がファイルパスであることを想定している場合に有用で、Windowsホストでは、前方スラッシュがバックスラッシュに変換される可能性があります。

デフォルト値の使用

変数が設定されていない場合にデフォルト値を使用するには、次のようにします：

%{variable:-default}

例

以下のセクションはQt Creator 変数の使用例です。

現在の文書の変数

%{CurrentDocument} 変数は、エディタで現在開いているファイルに関する情報に展開されます。

例えば

• %{CurrentDocument:Project:Name} はドキュメントを含むプロジェクトの名前に展開されます。
• %{CurrentDocument:FileName} ドキュメントの名前に展開されます。
• %{CurrentDocument:FilePath} はファイル名を含むドキュメントのフルパスに展開されます。
• %{CurrentDocument:DirName} ドキュメントの親ディレクトリ名に展開されます。

キットとビルドの設定変数

%{Project:DirName} 変数はプロジェクトフォルダーの名前に展開され、%{Kit:FileSystemName} はビルドと実行キットの情報に展開され、%{BuildConfig:Name} はビルド構成の名前に展開されます。

これらを組み合わせて、Preferences>Build & Run >Default Build Properties でDefault build directory を設定することができます：

../build-%{Project:DirName}-%{Kit:FileSystemName}-%{BuildConfig:Name}

Qt 変数

%{Qt} 変数は Qt インストールに関する情報に展開されます。

%{Qt:Version} は Qt インストールのバージョン番号に展開されます。キット名で使用できます。

デバイス変数

%{Device} 変数は、プロジェクトを実行するデバイス（run device）に関する情報に展開されます。

例えば

• %{Device:HostAddress} デバイスのホスト名やIPアドレスに展開されます。SSH認証に使用できます。
• %{Device:PrivateKeyFile} 秘密鍵ファイルのファイル名とパスに展開されます。SSH 認証に使用できます。
• %{Device:SshPort} SSH 接続用のポート番号に展開されます。
• %{Device:UserName} デバイスにログインするためのユーザー名に展開されます。デバイスが自動的に接続されない場合のカスタム接続に使用できます。

Git変数

%{Git:Config:user.name} Git設定のユーザー名に展開されます。ライセンスヘッダーテンプレートや、Gitユーザー名が必要なフィールドで使用できます。