cpp(1) manページ

以下が C プリプロセッサが受け付けるオプションの一覧です。これらのオプションは、プリプロセッサがコンパイラから起動されている場合にも自動的に引き渡されるので、 C プログラムをコンパイルする際にも指定することができます。

-P	` # amp;'-行番号という行番号情報をプリプロセッサの出力に含めません。これは、C 以外の言語で行番号情報が含まれているとエラーを起こす言語を処理する場合に有用でしょう。
-C	コメントを削除せず、そのまま出力ファイルに含めます。マクロ呼び出しの引数に現れるコメントはマクロ呼び出しの展開後にコピーされます。
-traditional
	ANSI ではなく、旧形式の C の文法として解釈します。
-trigraphs
	ANSI標準のトリグラフ(trigraph)構文を処理します。これは ANSI C で 1 文字を表示すると定められた ` ?? amp;' で始まる 3 文字の並びです。例えば、` ??/ amp;' は ` \' を表しますので、` '??/n' amp;' は改行文字の文字定数となります。厳密に言えば、GNU C プリプロセッサの ` -trigraphs amp;' オプションは ANSI C 標準を完全にはサポートしません。が、普通のユーザならばその違いに気づく事は稀でしょう。トリグラフについて、これ以上知りたいとは思わないでしょ?
-pedantic
	` #else amp;' や ` #endif amp;' の後にコメント以外のテキストがつくといった場合に、 ANSI C 標準で求められる警告を出力します。
-pedantic-errors
	` -pedantic amp;' に似ていますが、警告ではなくエラーにします。
-Wtrigraphs
	トリグラフがあると警告を出力します(ただし、トリグラフの処理は行います)。
-Wcomment
-Wcomments
	コメント開始シーケンスである ` /* amp;' がコメント中に存在したならば警告を発生します (両形式は同じ効果を持ちます)。
-Wall	` -Wtrigraphs amp;' と ` -Wcomment amp;' (ただし ` -Wtraditional amp;' は除く) を指定したのと同じです。
-Wtraditional
	ANSI と伝統派の C とで異なる振る舞いをとる構文が出現した場合に警告を発します。
-I directory
	amp; ディレクトリ directory amp; をヘッダファイルを検索するディレクトリリストの末尾に追加します。このオプションは、指定したディレクトリがシステムのヘッダファイルが格納されているディレクトリよりも先に検索されるので、ユーザ自身の作成したバージョンでシステムが提供するヘッダファイルを上書きさせることもできます。 1 つ以上の ` -I amp;' オプションを使用する場合、ディレクトリは左から右の順番で検索され、標準のシステムヘッダファイルはその後になります。
-I-	` -I- amp;' オプションよりも前に指定された ` -I amp;' オプションで与えられたディレクトリは、` #include amp;" file amp;" amp;' のインクルード文の場合にのみ検索されます。` #include < file amp;> amp;' では検索されません。オプション ` -I- amp;' の後のオプション ` -I amp;' に追加のディレクトリが指定された場合、それらのディレクトリは全ての ` #include amp;' 文で検索されます。付け加えて言うならば、` -I- amp;' オプションを指定すると、カレントディレクトリは ` #include amp;"file amp;" amp;' 文に対する最初の検索ディレクトリではなくなります。それゆえ、カレントディレクトリは明示的に ` -I. amp;' として指定された場合にのみ検索されることになります。 ` -I- amp;' と ` -I. amp;' を双方とも指定することで、どのディレクトリがカレントディレクトリの前に、あるいは後に検索されるかを厳密に指定することができます。
-nostdinc
	ヘッダファイルの検索に標準システムディレクトリを用いません。` -I amp;' オプションで指定したディレクトリ(と、もし適切であるならばカレントディレクトリ)が検索されます。
-nostdinc++
	ヘッダファイルの検索に C++ 仕様の標準ディレクトリを用いません。が、その他の標準ディレクトリは検索します。 (このオプションは libg++ の構築時に用いられます。)
-D name
	amp; name amp; を既定義のマクロとして、` 1 amp;' に定義します。
-D name=definition
	amp; name amp; をマクロとして definition amp; に定義します。 definition amp; の内容に制限はありませが、プリプロセッサをシェルやシェルに類似したプログラムから起動している場合、シェルの文法上意味を持つスペースなどの文字を保護するため、そのシェルのクォート文法を使用する必要があります。もし、1 つの name amp; に対して複数の ` -D amp;' を指定したならば、もっとも右側の定義が有効となります。
-U name
	amp; name amp; を定義しません。同一の name amp; に対して ` -U amp;' と ` -D amp;' の双方が指定された場合、` -U amp;' が ` -D amp;' に優先し、 name amp; は定義されません。
-undef	非標準のマクロを一切定義しません。
-A name(value)
	( #assert amp; コマンドと同じ方法で) 述語 name amp; にトークンリスト value amp; をアサートします。シェルのコマンドライン上では括弧をエスケープするなりクォートすることを忘れないで下さい。既定義のアサーション全てを取り消すのに、` -A- amp;' を使えます。これはまた、既定義のマクロ全てを無効にします。
-dM	プリプロセッサの結果を出力する代わりに、プリプロセッサの実行中に定義された、既定義のものも含む全てのマクロの ` #define amp;' コマンドのリストを出力します。これは、使用しているプリプロセッサのそのバージョンで、どんなマクロが既定義であるかを知る方法を提供してくれます。それには、空のファイル ` foo.h amp;' をこのオプションで処理してみればよいのです。 touch foo.h; cpp -dM foo.h はすべての既定義マクロの値を見せてくれるでしょう。
-dD	` -dM amp;' に似ていますが、2 つの相違点があります。これは既定義マクロを出力しません amp;。また、` #define amp;' コマンドとプリプロセス結果の双方 amp; を出力します。これらの出力は両方とも標準出力に行われます。
-M [-MG]	プリプロセスの結果を出力する代わりに、main のソースファイルの依存性を記述する make amp; 規則を出力します。プリプロセッサはソースファイルのオブジェクトファイル名、コロン、そのすべてのインクルードファイル名から成る make amp; 規則を出力します。複数のインクルードファイルがある場合、規則は` \\ amp;'-改行で複数行に区切られます。 ` -MG amp;' は、見つけられなかったヘッダファイルは(コンパイルの途中で)生成され、ソースファイルと同じディレクトリに存在するものとして扱います。` -M amp;' と共に指定しなければなりません。この機能は自動的に Makefile を更新するのに使います。
-MM [-MG]	これは ` -M amp;' に似ていますが、` #include " file amp;" amp;' でインクルードされるファイルのみを扱う点が異なります。` #include < file amp;> amp;' でインクルードされるシステムヘッダファイルは無視されます。
-MD file	これも ` -M amp;' に似ていますが、依存情報が` file amp;' に書き出されます。amp;` -MD amp;' を指定したファイルの処理もこれに加えて行われ、` -M amp;' のように通常の処理を抑制することはありません。 gcc を実行する場合は ` file amp;' 引数を指定してはいけません。gcc は、入力ファイル名の末尾の ` .c amp;' を ` .d amp;' で置き換えたファイル名を出力に用いるからです。 Mach では、` make amp;' コマンドで便利なように複数のファイルを 1 つの依存規則ファイルにまとめるユーティリティ md amp; が利用できます。
-MMD file	` -MD amp;' に似ていますが、ユーザのヘッダファイルのみを扱い、システムヘッダは無視する点が異なります。
-H	通常の動作に加えて、使用されたヘッダファイルのファイル名を出力します。
-imacros file
	amp; ファイル file amp; を入力として処理しますが、標準の入力ファイルを処理する前にその結果の出力を破棄します。 file amp; によって生成される出力は捨てられるため、` -imacros file amp; amp;' の処理結果の影響は、 file amp; 中に記述されたマクロがメインの入力ファイル中で使用可能になることだけです。プリプロセッサは、` -imacros file amp;' を処理する前に、コマンドラインから与えられた全ての ` -D amp;' や ` -U amp;' オプションを評価します。
-include file
	amp; ファイル file amp; を、標準の入力ファイルの前に処理し、その結果出力をインクルードします。
-idirafter dir
	ディレクトリ dir amp; を第 2 インクルードパスに加えます。第 2 インクルードパス中のディレクトリは、メインインクルードパス (オプション ` -I amp;' によって追加されます) 中にヘッダファイルを探した結果発見できなかった場合に検索されます。
-iprefix prefix
	prefix amp; を、その後に続く ` -iwithprefix amp;' オプション用のプレフィックスとして使用します。
-iwithprefix dir
	ディレクトリを第 2 インクルードパスに追加します。ディレクトリ名は prefix amp; と dir amp; を連結することによって得られます。ここで prefix は ` -iprefix amp;' オプションによって指定されたものです。
-lang-c
-lang-c++
-lang-objc
-lang-objc++
	ソースの言語を指定します。` -lang-c++ amp;' は、プリプロセッサに C++ のコメント文と、C++ 用の追加のデフォルトインクルードディレクトリを処理させ、` -lang-objc amp;' は、Objective C の ` #import amp;' ディレクティブを使用可能にします。` -lang-c amp;' は明示的にこれらの機能の切り離しを指定し、` -lang-objc++ amp;' は双方を利用可能にします。これらのオプションはコンパイラドライバ gcc amp; によって生成されますが、` gcc amp;' のコマンドラインから引き渡すことはできません。
-lint	コメント中に埋め込まれた、プログラムチェッカ lint amp; のコマンドを見つけ出し、それらの前に ` #pragma lint amp;' を埋め込みます。例えば、コメント ` */ NOTREACHED /* amp;' は ` #pragma lint NOTREACHED amp;' になります。このオプションは直接 cpp amp; を呼び出す場合にのみ使えます。 gcc amp; は、コマンドラインからこのオプションを引き渡しません。
-$	識別子中での ` $ amp;' の使用を禁止します。これは、標準が修正される以前は、C 標準への厳密な準拠のためにありました。本オプションは、 cpp を直接呼ぶときのみ使用可能です。 gcc はコマンド行からこれを渡しません。

»	ヘッダファイルを読み込みます。これはプログラムに組み込まれる (C 言語の)宣言の入ったファイルです。
»	C 言語の任意の部分の省略形としてマクロ amp;を定義し、C プリプロセッサがプログラム内の全てのマクロをその定義で置き換えます。
»	条件文の処理をします。専用のプリプロセッサコマンドを用いて、いろいろな条件にしたがってプログラムの一部を含めたり除外したりできます。
»	行番号の制御をします。ソースファイルとコンパイルされた中間ファイルとを組み合わせたり再アレンジしたりするプログラムを用いる場合、コンパイラにオリジナルのソースの何行目であるかを知らせるための、行番号制御のプリプロセッサコマンドを利用できます。

manページ — cpp

名称

内容

書式

解説

オプション

関連項目

COPYING