Qt Creator 変数の使用

Preferences 、Build Settings 、およびRun Settings では、引数、実行ファイルのパス、作業ディレクトリなどを設定するフィールドなどで、Qt Creator の変数を使用できます。変数の展開には自動的に引用符が付けられるため、変数を引用符で囲む必要はありません。

フィールド内の「 （Variables ）」ボタンを選択すると、特定のコンテキストで使用可能な変数のリストから選択できます。各変数の詳細については、リスト内でその変数にカーソルを合わせてください。

以下の構文を使用すると、環境変数をQt Creator 変数として使用できます：%{Env:VARNAME}。

パターン置換

Qt Creator は、変数名を展開する際にパターン置換を使用します。変数内のパターンの最初の一致を置換文字列に置き換えるには、次のように指定します:

%{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} は、ドキュメントの親ディレクトリ名に展開されます。

Kitおよびビルド設定変数

%{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} 変数は、プロジェクトを実行しているデバイス（実行デバイス）に関する情報に展開されます。

例：

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

Git 変数

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