#show

説明

このマクロ・プリプロセッサ指示文は、インクルード・ファイルに記述されているコメント・セクションを開始します。既定で、インクルード・ファイル内のコメントは、呼び出し元のコードには表示されません。したがって、#show から #noshow の範囲外にあるインクルード・ファイルのコメントは、参照元コードには表示されません。

この指示文の形式は、以下のとおりです。

#show

コメント・セクションがファイルの最後まで続く場合でも、それぞれの #show に対応する #noshow を指定することを強くお勧めします。

次の例で、#include の例として挙げたファイル OS.inc には以下のコメントが記述されています。

#show
  // If compilation fails, check the file 
  // OS-errors.log for the statement "No valid OS."
#noshow
  // Valid values for the operating system are 
  // Windows or UNIX (and are case-sensitive).

ここで、最初の 2 行のコメント (If compilation fails... で始まる) は、インクルード・ファイルを含むコードに表示され、次の 2 行のコメント (Valid values... で始まる) は、インクルード・ファイル自体にのみ表示されます。