Rational Developer for System z

エディターにおけるプリプロセッサー・ステートメント

エディターには、プリプロセッサー・ステートメントを識別して検証するために役立つフィーチャーがいくつかあります。

プリプロセッサー・ステートメント とは、作成中のコードを拡張したり単純化したりするための、開発環境でサポートされるカスタマイズされた言語ステートメントです。これらのステートメントは、プログラムのコンパイル前にプログラミング言語ステートメントに変換されます。エディターの設定やツールバー・タスクを使用すると、エディターのツールによってこれらのステートメントをサポートできます。

「プリプロセッサーの統合」設定を使用すると、編集中にプリプロセッサーの実行をトリガーして、プリプロセッサー・ステートメントからの出力が予想どおりであることを確認できます。プリプロセッサー出力ファイルには、プリプロセッサー・ステートメントから生成されたプログラミング言語ステートメントが入ります。出力ファイルのロケーションは、プリプロセッサーがローカルであるかリモートであるかに応じて異なります。

ローカル・プリプロセッサーの場合、出力ファイルはプロパティー・グループの「プリプロセッサー出力ファイル名」オプションによって定義され、ローカル・プロジェクトの BuildOutput フォルダー内に位置します。リモート・プリプロセッサーの出力ファイルは、「エディター構成」ページの「プリプロセッサーの出力の場所」プロパティーによって定義されます。

プリプロセッサーの出力はエディター機能 (吹き出しヘルプやコンテンツ・アシストなど) を提供するために使用されますが、以下のような制限があります。

エディター・ツールの機能 (例えば、構文エラーなど) は、プリプロセッサーがファイル内に生成した出力に対してのみ適用されます。

プリプロセッサーの呼び出しは、「プリプロセッサーの統合」設定での定義に応じて、ファイルを開いたとき、またはファイルを保存するときに自動的に実行されます。また、エディターの「ソース」メニューを使用して手動でプリプロセッサーを呼び出すこともできます。

「プリプロセッサーの統合」設定には、プリプロセッサー・ステートメントがエディターによってどのように識別されるかに影響を与える設定もあります。それらの設定を使用すると、プリプロセッサー・ステートメントと、プリプロセッサー・ステートメント以外のコメントや非構文テキストを識別できるように設定できます。

エディターの「ソース」メニューには、プリプロセッサー・ステートメントを識別するための以下のようなアクションが用意されています。
構成済みプリプロセッサーを使用した識別
プログラム内のステートメントを、指定されたプリプロセッサーと比較します。 プリプロセッサー内のステートメントと一致するステートメントが、プリプロセッサー・ステートメントとしてマークされます。
特定の出力ファイルを使用した識別
プログラム内のステートメントを、プリプロセッサーを以前に呼び出したときに識別された出力ファイルと比較します。出力ファイルと一致するステートメントが、プリプロセッサー・ステートメントとしてマークされます。
プリプロセッサー・ステートメントを識別するマークを除去するには、「識別のクリア (Clear Identifications)」メニュー項目を使用します。
その他のアクション項目として、プリプロセッサーの設定や構成にアクセスする機能が提供されています。
プリプロセッサーの構成
プロパティー・グループにアクセスして、プリプロセッサーの呼び出しや、プリプロセッサー出力ファイルの取得のためのメカニズムを構成できます。プロパティー・グループ・エディターでは、使用しているプリプロセッサーのタイプに応じて、該当する「エディター構成」ページが開かれます。
設定
「プリプロセッサーの統合」設定にアクセスできます。

フィードバック