ソース コード フォーマッタ への移動
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\19.0 。
- RAD Studio のインストール ディレクトリ。デフォルトでは、
C:\Program Files (x86)\Embarcadero\Studio\19.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 のオプションを使用して言語を指定する必要があります。
|
関連項目