ソース コード フォーマッタ への移動
Formatter.exe は、Delphi と C/C++ のソース コード ファイル用のコマンドライン フォーマッタです。
Formatter.exe は、スタンドアロンのアプリケーションであるため、その実行にはサポート DLL やその他の実行モジュールは必要ありません。
ソース コード ファイルがコンパイルできない場合は、整形結果が間違っている可能性があります。
コマンドライン構文
簡単なヘルプを表示するには、次のように入力します。
Formatter [-h]
コマンド インタープリタからソース コード フォーマッタを実行するには、次のコマンドライン構文を使用します。
Formatter [<options>] [<filename>...]
コマンドライン オプション
以下のオプションを指定することができます。
| オプション
|
説明
|
|
-h
|
コマンドライン フォーマッタの簡単なヘルプを表示するには、このオプションを使用します（または、何もオプションを指定しません）。
|
|
-cpp
|
定義済みの C/C++ 拡張子を持つファイルのみを整形します（その他の拡張子が filename オプションで指定されていない場合）。
定義済みの C/C++ 拡張子は次のとおりです。
*.cpp、*.cxx、*.cc、*.c、*.hpp、*.hxx、*.hh、*.h。
|
|
-delphi
|
定義済みの Delphi 拡張子を持つファイルのみを整形します（その他の拡張子が filename オプションで指定されていない場合）。
定義済みの Delphi 拡張子は次のとおりです。
*.pas、*.dpr、*.dpk、*.dpkw、*.inc。
|
-config configfile
-config:configfile
|
configfile -- 構成ファイル名。ソース ファイルは、configfile に保存されている整形オプションに従って整形されます。
構成ファイルは、［オプション］ダイアログ ボックス（［ツール｜オプション...｜フォーマッタ｜プロファイルと状態］）の［プロファイルと状態］ページから作成できます。
configfile では以下のデフォルトが使われます。
configfile によってファイル名が指定されていない場合は、フォーマッタは Formatter.config ファイルを探します。- 拡張子のみを省略した場合は、（必要であれば）
.config 拡張子を持つと見なされます。
configfile が完全修飾ファイル名でない場合は、フォーマッタは次の順番で configfile を探します。
- 現在のディレクトリ。
- RAD Studio の作業ディレクトリ。デフォルトでは、
C:\Users\<username>\AppData\Roaming\Embarcadero\BDS\21.0。
- RAD Studio のインストール ディレクトリ。デフォルトでは、
C:\Program Files (x86)\Embarcadero\Studio\21.0\bin\config。
|
|
-e encoding
-e:encoding
|
encoding には、読み取り/書き込みの際のエンコードを指定します。このオプションを省略した場合は、フォーマッタがソースを読み込んで、自動的に適切なエンコードを決定しようと試みます。
|
|
-d directory
-d:directory
|
directory には、整形対象のファイルを含むフォルダを指定します。filename が指定されていない場合は、directory フォルダ内にある、Delphi と C/C++ の両方の定義済み拡張子（または、-cpp または -delphi が指定されている場合は、それに対応する拡張子）を持つすべてのファイルが整形されます。
|
|
-r
|
directory フォルダとすべてのサブディレクトリを再帰的にたどって、ファイルを整形します。
|
|
-b
|
整形する前に、ファイルのコピー（.bak 拡張子が付加される）を作成します。
|
|
-log logfile
-log:logfile
|
logfile には、フォーマッタがメッセージを書き込むログ ファイル名を指定します。デフォルトでは、フォーマッタはコンソールにメッセージを書き込みます。
|
|
-silent
|
エラー メッセージを表示しません。
|
|
filename
|
filename には、整形対象のソース ファイルの名前を指定します。フォーマッタは、整形済みのソース テキストを同じファイルに書き込みます。
複数の filename をスペースで区切って指定することもできます。ワイルドカード文字の '*' と '?' を使用することもできます。
filename の拡張子にワイルドカード文字が使われている場合は、Delphi と C/C++ の両方の定義済み拡張子を待つすべてのファイル（または、-cpp または -delphi オプションが指定されている場合は、それに対応する拡張子を持つファイル）が整形されます。
定義済みでない拡張子を持つファイルを整形するには、-cpp または-delphi のオプションを使用して言語を指定する必要があります。
|
関連項目