Unix-commands-cpp

cpp-Unix、Linuxコマンド

link：/unix_commands/index [previous] link：/unix_commands/index [next] [[1]] php [AddThis Social Bookmark Button]

概要

*-D * *macrodefn -U * *macro -I * *dir -iquote * *dir -W * *warn -M-MM-MG-MF * *filename -MP-MQ target -MT * *target -P-fno-working-directory-x * *language *-std = * *standardinfileoutfile

最も有用なオプションだけがここにリストされています。残りについては下記を参照してください。

説明

cppmacroプロセッサmacros

Cプリプロセッサは、C、C ++、およびObjective-Cソースコードでのみ使用することを目的としています。 過去には、一般的なテキストプロセッサとして悪用されていました。 それはCの語彙規則に従わない入力を詰まらせるでしょう。 たとえば、アポストロフィは文字定数の始まりとして解釈され、エラーを引き起こします。 また、Cファミリ言語にとって重要ではない入力の特性を保持することに頼ることはできません。 Makefileが前処理されていると、すべてのハードタブが削除され、Makefileは機能しません。

そうは言っても、C以外のものにcppを使用することで回避できることがよくあります。 他のAlgolっぽいプログラミング言語（Pascal、Adaなど）はしばしば安全です。* -traditional-cpp *モードはより多くの空白を保持し、それ以外の場合はより寛容です。 多くの問題は、母国語のコメントではなくCまたはCスタイルのコメントを記述し、マクロを単純にすることで回避できます。

可能な限り、あなたが書いている言語に適したプリプロセッサを使うべきです。 最新版のGNUアセンブラにはマクロ機能があります。 ほとんどの高水準プログラミング言語には、独自の条件付きコンパイルおよび包含メカニズムがあります。 それでもうまくいかない場合は、GNU M4などの一般的なテキストプロセッサを試してください。

Cプリプロセッサの詳細はいくつか異なります。 このマニュアルでは、ISO C標準の機能の小さなスーパーセットを提供するGNU Cプリプロセッサについて説明します。 デフォルトモードでは、GNU Cプリプロセッサは標準で必要ないくつかのことを行いません。 これらはめったに使用されない機能であり、それらを予期しないプログラムの意味に驚くべき変化を引き起こす可能性があります。 厳密なISO標準Cを取得するには、使用する標準のバージョンに応じて、-std = c89 *または *-std = c99 オプションを使用する必要があります。 すべての必須診断を取得するには、*-pedantic *も使用する必要があります。

このマニュアルでは、ISOプリプロセッサの動作について説明しています。 ISOプリプロセッサの動作が従来のセマンティクスと競合しない、不要な違いを最小限に抑えるには、従来のプリプロセッサも同じように動作する必要があります。 存在するさまざまな違いについては、「従来モード」セクションで詳しく説明します。

明確にするために、特に明記しない限り、このマニュアルの CPP への言及はGNU CPPを指します。

オプション

infileoutfileinfile ＃include _ outfile_

_infile_または_outfile_のいずれかを*-にすることができます。これは、_infile_が標準入力から読み取ることを意味し、_outfile_が標準出力に書き込むことを意味します。 また、いずれかのファイルが省略された場合、そのファイルに-*が指定された場合と同じことを意味します。

特に断りのない限り、またはオプションが = で終わる場合、引数を取るすべてのオプションは、オプションの直後、またはオプションと引数の間にスペースを入れて引数を表示できます： -Ifoo および -I foo have同じ効果。

多くのオプションには複数文字の名前があります。したがって、複数の単一文字オプションをグループ化することはできません。-dM *は *-d -M とは大きく異なります。

Tag	Description
-D name	Predefine name as a macro, with definition 1.
-D name=definition	The contents of definition are tokenized and processed as if they appeared during translation phase three in a *#define *directive. In particular, the definition will be truncated by embedded newline characters. シェルまたはシェルのようなプログラムからプリプロセッサを呼び出す場合は、シェルの引用構文を使用して、シェル構文で意味を持つスペースなどの文字を保護する必要があります。 コマンドラインで関数のようなマクロを定義する場合は、等号の前にかっこを付けて引数リストを記述します（存在する場合）。 括弧はほとんどのシェルにとって意味があるため、オプションを引用する必要があります。* sh および *csh では、*-D ’ name （ args …​ ）= * *definition ’ *が機能します。 -D* および *-U* オプションは、コマンドラインで指定された順序で処理されます。 すべての *-imacros* _file_および *-include* _file_オプションは、すべての *-D* および *-U* オプションの後に処理されます。
*-U *name	Cancel any previous definition of name, either built in or provided with a* -D* option.
-undef	Do not predefine any system-specific or GCC-specific macros. The standard predefined macros remain defined.
-I dir	Add the directory dir to the list of directories to be searched for header files. -I* という名前のディレクトリは、標準システムにディレクトリが含まれる前に検索されます。 ディレクトリ_dir_が標準システムインクルードディレクトリである場合、システムディレクトリのデフォルトの検索順序とシステムヘッダーの特別な処理が無効にならないようにするため、オプションは無視されます。 .
*-o *file	Write output to file. This is the same as specifying file as the second non-option argument to* cpp*. gcc *has a different interpretation of a second non-option argument, so you must use -o* to specify the output file.
*-Wall *	Turns on all optional warnings which are desirable for normal code. At present this is* -Wcomment*, -Wtrigraphs, -Wmultichar and a warning about integer promotion causing a change of sign in #if expressions. Note that many of the preprocessor’s warnings are on by default and have no options to control them.
-Wcomment
*-Wcomments *	Warn whenever a comment-start sequence*/* appears in a/* comment, or whenever a backslash-newline appears in a//* comment. (Both forms have the same effect.)
-Wtrigraphs	Most trigraphs in comments cannot affect the meaning of the program. However, a trigraph that would form an escaped newline (??/ at the end of a line) can, by changing where the comment begins or ends. Therefore, only trigraphs that would form escaped newlines produce warnings inside a comment. このオプションは、-Wall *によって暗示されています。 *-Wall が指定されていない場合、トライグラフが有効になっていない限り、このオプションは有効のままです。 警告なしでトライグラフ変換を取得し、他の -Wall 警告を取得するには、*-trigraphs -Wall -Wno-trigraphs *を使用します。
-Wtraditional	Warn about certain constructs that behave differently in traditional and ISO C. Also warn about ISO C constructs that have no traditional C equivalent, and problematic constructs which should be avoided.
*-Wimport *	Warn the first time* #import* is used.
*-Wundef *	Warn whenever an identifier which is not a macro is encountered in an* #if directive, outside of defined*. Such identifiers are replaced with zero.
-Wunused-macros	Warn about macros defined in the main file that are unused. A macro is used if it is expanded or tested for existence at least once. The preprocessor will also warn if the macro has not been used at the time it is redefined or undefined. 組み込みマクロ、コマンドラインで定義されたマクロ、およびインクルードファイルで定義されたマクロは警告されません。 _注：_マクロが実際に使用され、スキップされた条件ブロックでのみ使用されている場合、CPPはそれを未使用として報告します。 このような場合の警告を回避するには、たとえば最初にスキップしたブロックにマクロを移動することにより、マクロの定義の範囲を改善することができます。 または、次のようなダミーの使用を提供できます。 ++

a|

        #if defined the_macro_causing_the_warning
        #endif

Copy

*-Wendif-labels *a

Warn whenever an* #else or an #endif* are followed by text. This usually happens in code of the form ++ [width="100%",cols="100%",]

a|

        #if FOO
        ...
        #else FOO
        ...
        #endif FOO

Copy

2番目と3番目の `+ FOO +`はコメントに含める必要がありますが、多くの場合、古いプログラムにはありません。 この警告はデフォルトでオンになっています。

-Werror

Make all warnings into hard errors. Source code which triggers warnings will be rejected.

-Wsystem-headers

Issue warnings for code in system headers. These are normally unhelpful in finding bugs in your own code, therefore suppressed. If you are responsible for the system library, you may want to see them.

-w

Suppress all warnings, including those which GNU CPP issues by default.

-pedantic

Issue all the mandatory diagnostics listed in the C standard. Some of them are left out by default, since they trigger frequently on harmless code.

*-pedantic-errors *

Issue all the mandatory diagnostics, and make all mandatory diagnostics into errors. This includes mandatory diagnostics that GCC issues without* -pedantic* but treats as warnings.

*-M *a

Instead of outputting the result of preprocessing, output a rule suitable for* make describing the dependencies of the main source file. The preprocessor outputs one make rule containing the object file name for that source file, a colon, and the names of all the included files, including those coming from -include or -imacros* command line options. （ -MT または -MQ で）明示的に指定されていない限り、オブジェクトファイル名は、ソースファイルのベース名から構成され、サフィックスはオブジェクトファイルのサフィックスに置き換えられます。 含まれるファイルが多数ある場合、ルールは \ -newlineを使用して複数の行に分割されます。 ルールにはコマンドがありません。 このオプションは、-dM *などのプリプロセッサのデバッグ出力を抑制しません。 そのようなデバッグ出力が依存関係ルールと混ざらないようにするには、依存関係出力ファイルを *-MF で明示的に指定するか、 DEPENDENCIES_OUTPUT などの環境変数を使用する必要があります。 通常どおり、デバッグ出力は通常の出力ストリームに送信されます。 -M をドライバーに渡すと、-E *が暗黙的に指定され、暗黙の *-w で警告が抑制されます。

*-MM *a

Like* -M* but do not mention header files that are found in system header directories, nor header files that are included, directly or indirectly, from such a header. これは、＃include *ディレクティブでの山括弧または二重引用符の選択自体が、ヘッダーが​​ -MM *依存関係出力に表示されるかどうかを決定しないことを意味します。 これは、GCCバージョン3.0以前からのセマンティクスのわずかな変更です。

*-MF *file

When used with* -M or -MM*, specifies a file to write the dependencies to. If no -MF switch is given the preprocessor sends the rules to the same place it would have sent preprocessed output. ドライバオプション -MD または -MMD を使用すると、*-MF *はデフォルトの依存関係出力ファイルを上書きします。

*-MG *a

In conjunction with an option such as* -M requesting dependency generation, -MG assumes missing header files are generated files and adds them to the dependency list without raising an error. The dependency filename is taken directly from the #include directive without prepending any path. -MG* also suppresses preprocessed output, as a missing header file renders this useless. この機能は、メイクファイルの自動更新で使用されます。

*-MP *a

This option instructs CPP to add a phony target for each dependency other than the main file, causing each to depend on nothing. These dummy rules work around errors* make* gives if you remove header files without updating the Makefile to match. これは典型的な出力です： ++ [width="100%",cols="100%",]

a|

        test.o: test.c test.h

Copy

++ [width="100%",cols="100%",]

a|

        test.h:

Copy

*-MT *target

Change the target of the rule emitted by dependency generation. By default CPP takes the name of the main input file, including any path, deletes any file suffix such as* .c*, and appends the platform’s usual object suffix. The result is the target. -MT* オプションは、ターゲットを指定した文字列に正確に設定します。 複数のターゲットが必要な場合は、それらを *-MT* の単一の引数として指定するか、複数の *-MT* オプションを使用できます。 たとえば、*-MT ’$（objpfx）foo.o’ *は、 ++

a|

        $(objpfx)foo.o: foo.c

Copy

*-MQ *target

Same as* -MT*, but it quotes any characters which are special to Make. -MQ ’$(objpfx)foo.o’ gives ++

a|

        $$(objpfx)foo.o: foo.c

Copy

デフォルトのターゲットは、*-MQ *で指定されたかのように、自動的に引用されます。

*-MD *a

-MD is equivalent to -M -MF file, except that -E is not implied. The driver determines file based on whether an -o* option is given. If it is, the driver uses its argument but with a suffix of .d, otherwise it take the basename of the input file and applies a .d suffix. -MD を -E と組み合わせて使用​​すると、-o *スイッチは依存関係出力ファイルを指定するものと解釈されます（ただし、 + @ pxref + \ {dashMF ,,-MF}）。ただし、 *-E 、各 -o はターゲットオブジェクトファイルを指定すると理解されます。 -E は暗黙指定されないため、コンパイルプロセスの副作用として、*-MD *を使用して依存関係出力ファイルを生成できます。

*-MMD *

Like* -MD* except mention only user header files, not system header files.

-x c

-x c++

-x objective-c

*-x assembler-with-cpp *a

Specify the source language: C, C, Objective-C, or assembly. This has nothing to do with standards conformance or extensions; it merely selects which base syntax to expect. If you give none of these options, cpp will deduce the language from the extension of the source file:* .c*, *.cc*, *.m*, or *.S*. Some other common extensions for C and assembly are also recognized. If cpp does not recognize the extension, it will treat the file as C; this is the most generic mode. 注： cppの以前のバージョンは、言語と標準適合レベルの両方を選択する -lang オプションを受け入れました。 このオプションは -l オプションと競合するため、削除されました。

-std=standard

*-ansi *a

Specify the standard to which the code should conform. Currently CPP knows about C and C++ standards; others may be added in the future. _standard_は次のいずれかです。 [width="100%",cols="50%,50%",options="header",]

|Tag |Description |iso9899:1990 | |c89 a| The ISO C standard from 1990.* c89* is the customary shorthand for this version of the standard.

*-ansi* オプションは *-std = c89* と同等です。

Copy

|iso9899:199409 |The 1990 C standard, as amended in 1994. |iso9899:1999 | |c99 | |iso9899:199x | |c9x |The revised ISO C standard, published in December 1999. Before publication, this was known as C9X. |gnu89 |The 1990 C standard plus GNU extensions. This is the default. |gnu99 | |gnu9x |The 1999 C standard plus GNU extensions. |+c98+` |The 1998 ISO C standard plus amendments. |+gnu98+` |The same as *-std=c98* plus GNU extensions. This is the default for C++ code.

*-I- *a	Split the include path. Any directories specified with* -I options before -I- are searched only for headers requested with #include "file"; they are not searched for #include <file>. If additional directories are specified with -I options after the -I-, those directories are searched for all *#include directives. さらに、*-I- *は、現在のファイルディレクトリのディレクトリを、 `+＃include" + + file + + "+`の最初の検索ディレクトリとして使用することを禁止します。 このオプションは廃止されました。
*-nostdinc *	Do not search the standard system directories for header files. Only the directories you have specified with* -I* options (and the directory of the current file, if appropriate) are searched.
-nostdinc++	Do not search for header files in the C-specific standard directories, but do still search the other standard directories. (This option is used when building the C library.)
-include file	Process file as if #include "file" appeared as the first line of the primary source file. However, the first directory searched for file is the preprocessor’s working directory instead of the directory containing the main source file. If not found there, it is searched for in the remainder of the #include "..." search chain as normal. 複数の -include オプションが指定されている場合、ファイルはコマンドラインに表示される順序で含まれます。
*-imacros *file	Exactly like* -include*, except that any output produced by scanning file is thrown away. Macros it defines remain defined. This allows you to acquire all the macros from a header without also processing its declarations. -imacros* で指定されたすべてのファイルは、*-include *で指定されたすべてのファイルの前に処理されます。
*-idirafter *dir	Search dir for header files, but do it after all directories specified with* -I* and the standard system directories have been exhausted. dir is treated as a system include directory.
*-iprefix *prefix	Specify prefix as the prefix for subsequent* -iwithprefix options. If the prefix represents a directory, you should include the final/*.
-iwithprefix dir
*-iwithprefixbefore *dir	Append dir to the prefix specified previously with* -iprefix*, and add the resulting directory to the include search path. -iwithprefixbefore *puts it in the same place -I would; -iwithprefix puts it where -idirafter* would.
*-isysroot *dir	This option is like the* --sysroot option, but applies only to header files. See the --sysroot* option for more information.
*-isystem *dir	Search dir for header files, after all directories specified by* -I* but before the standard system directories. Mark it as a system directory, so that it gets the same special treatment as is applied to the standard system directories.
*-iquote *dir	Search dir only for header files requested with #include "file"; they are not searched for #include <file>, before all directories specified by* -I* and before the standard system directories.
*-fdollars-in-identifiers *	Accept* $* in identifiers.
-fextended-identifiers	Accept universal character names in identifiers. This option is experimental; in a future version of GCC, it will be enabled by default for C99 and C++.
*-fpreprocessed *a	Indicate to the preprocessor that the input file has already been preprocessed. This suppresses things like macro expansion, trigraph conversion, escaped newline splicing, and processing of most directives. The preprocessor still recognizes and removes comments, so that you can pass a file preprocessed with* -C* to the compiler without problems. In this mode the integrated preprocessor is little more than a tokenizer for the front ends. 入力ファイルに拡張子 .i 、。ii *、または *.mi のいずれかがある場合、-fpreprocessed *は暗黙的です。 これらは、-save-temps *によって作成された前処理済みファイルにGCCが使用する拡張子です。
-ftabstop=width	Set the distance between tab stops. This helps the preprocessor report correct column numbers in warnings or errors, even if tabs appear on the line. If the value is less than 1 or greater than 100, the option is ignored. The default is 8.
-fexec-charset=charset	Set the execution character set, used for string and character constants. The default is UTF-8. charset can be any encoding supported by the system’s iconv library routine.
-fwide-exec-charset=charset	Set the wide execution character set, used for wide string and character constants. The default is UTF-32 or UTF-16, whichever corresponds to the width of wchar_t. As with -fexec-charset, charset can be any encoding supported by the system’s iconv library routine; however, you will have problems with encodings that do not fit exactly in wchar_t.
-finput-charset=charset	Set the input character set, used for translation from the character set of the input file to the source character set used by GCC. If the locale does not specify, or GCC cannot get this information from the locale, the default is UTF-8. This can be overridden by either the locale or this command line option. Currently the command line option takes precedence if there’s a conflict. charset can be any encoding supported by the system’s iconv library routine.
*-fworking-directory *	Enable generation of linemarkers in the preprocessor output that will let the compiler know the current working directory at the time of preprocessing. When this option is enabled, the preprocessor will emit, after the initial linemarker, a second linemarker with the current working directory followed by two slashes. GCC will use this directory, when it’s present in the preprocessed input, as the directory emitted as the current working directory in some debugging information formats. This option is implicitly enabled if debugging information is enabled, but this can be inhibited with the negated form* -fno-working-directory*. If the -P flag is present in the command line, this option has no effect, since no #line directives are emitted whatsoever.
*-fno-show-column *	Do not print column numbers in diagnostics. This may be necessary if diagnostics are being scanned by a program that does not understand the column numbers, such as* dejagnu*.
-A predicate=answer	Make an assertion with the predicate predicate and answer answer. This form is preferred to the older form -A predicate(answer), which is still supported, because it does not use shell special characters.
-A -predicate=answer	Cancel an assertion with the predicate predicate and answer answer.
-dCHARS	CHARS is a sequence of one or more of the following characters, and must not be preceded by a space. Other characters are interpreted by the compiler proper, or reserved for future versions of GCC, and so are silently ignored. If you specify characters whose behavior conflicts, the result is undefined.

|Tag |Description |M *a| Instead of the normal output, generate a list of #define* directives for all the macros defined during the execution of the preprocessor, including predefined macros. This gives you a way of finding out what is predefined in your version of the preprocessor. Assuming you have no file foo.h, the command

++

touch foo.h; cpp -dM foo.h

すべての定義済みマクロが表示されます。

|D *|Like M except in two respects: it does not include the predefined macros, and it outputs both the #define* directives and the result of preprocessing. Both kinds of output go to the standard output file. |N *|Like D*, but emit only the macro names, not their expansions. |I *|Output #include* directives in addition to the result of preprocessing.

-P	Inhibit generation of linemarkers in the output from the preprocessor. This might be useful when running the preprocessor on something that is not C code, and will be sent to a program which might be confused by the linemarkers.	-C	Do not discard comments. All comments are passed through to the output file, except for comments in processed directives, which are deleted along with the directive. -C* を使用する場合、副作用に備える必要があります。プリプロセッサは、コメントを独自のトークンとして処理します。 たとえば、ディレクティブ行となるものの先頭に表示されるコメントは、行の最初のトークンが*＃*でなくなるため、その行を通常のソース行に変換する効果があります。
*-CC *a	Do not discard comments, including during macro expansion. This is like* -C*, except that comments contained within macros are also passed through to the output file where the macro is expanded. -C オプションの副作用に加えて、-CC *オプションを使用すると、マクロ内のすべてのC ++スタイルのコメントがCスタイルのコメントに変換されます。 これは、そのマクロを後で使用して、ソース行の残りの部分を誤ってコメントアウトしないようにするためです。 -CC</emphasis> オプションは、一般的にlintコメントをサポートするために使用されます。	-traditional-cpp	Try to imitate the behavior of old-fashioned C preprocessors, as opposed to ISO C preprocessors.
-trigraphs	Process trigraph sequences.	-remap	Enable special code to work around file systems which only permit very short file names, such as MS-DOS.
--help		--target-help	Print text describing all the command line options instead of preprocessing anything.
-v	Verbose mode. Print out GNU CPP’s version number at the beginning of execution, and report the final form of the include path.	*-H *	Print the name of each header file used, in addition to other normal activities. Each name is indented to show how deep in the* #include stack it is. Precompiled header files are also printed, even if they are found to be invalid; an invalid precompiled header file is printed with …​x and a valid one with …​!* .
-version		--version	Print out GNU CPP’s version number. With one dash, proceed to preprocess as normal. With two dashes, exit immediately.

環境

CPP

*-I* などのオプションを使用して検索する場所を指定し、*-M *などのオプションで依存関係の出力を制御することもできます。 これらは環境変数よりも優先され、環境変数はGCCの構成よりも優先されます。

Copy

Tag	Description
CPATH
C_INCLUDE_PATH
CPLUS_INCLUDE_PATH
*OBJC_INCLUDE_PATH *a	Each variable’s value is a list of directories separated by a special character, much like* PATH*, in which to look for header files. The special character, PATH_SEPARATOR, is target-dependent and determined at GCC build time. For Microsoft Windows-based targets it is a semicolon, and for almost all other targets it is a colon. CPATH は、-I *で指定された場合と同様に、コマンドラインで *-I オプションで指定されたパスの後に検索するディレクトリのリストを指定します。 この環境変数は、どの言語が前処理されているかに関係なく使用されます。 残りの環境変数は、指定された特定の言語を前処理する場合にのみ適用されます。 それぞれは、-isystem *で指定された場合と同様に、コマンドラインで *-isystem オプションで指定されたパスの後に検索するディレクトリのリストを指定します。 これらすべての変数で、空の要素はコンパイラに現在の作業ディレクトリを検索するよう指示します。 空の要素は、パスの最初または最後に表示できます。 たとえば、 CPATH の値が `+：/special/include +`の場合、*-Iと同じ効果があります。 -I/special/include *。
DEPENDENCIES_OUTPUT	If this variable is set, its value specifies how to output dependencies for Make based on the non-system header files processed by the compiler. System header files are ignored in the dependency output. DEPENDENCIES_OUTPUT* の値は単なるファイル名にすることができます。この場合、Makeルールはそのファイルに書き込まれ、ソースファイル名からターゲット名を推測します。 または、値は_file_ ** _target_の形式を持つことができます。この場合、ルールは_target_をターゲット名として使用してファイル_file_に書き込まれます。 つまり、この環境変数は、オプション -MM および -MF をオプションの -MT スイッチと組み合わせることと同等です。
*SUNPRO_DEPENDENCIES *	This variable is the same as* DEPENDENCIES_OUTPUT (see above), except that system header files are not ignored, so it implies -M rather than -MM*. However, the dependence on the main input file is omitted.

関連項目

gplgfdlfsf-fundinggccasldcppgccbinutils

著作権

GNU Free Documentation License、バージョン1.1、またはFree Software Foundationによって公開されたそれ以降のバージョンの条件の下で、このドキュメントをコピー、配布、および/または変更する許可が与えられます。 ライセンスのコピーは、manページ_gfdl_（7）に含まれています。 このマニュアルには不変セクションは含まれていません。 表紙テキストは（a）（以下を参照）、裏表紙テキストは（b）（以下を参照）です。

（a）FSFの表紙テキストは次のとおりです。

++

A GNU Manual

（b）FSFの裏表紙のテキスト：

++

You have freedom to copy and modify this GNU Manual, like GNU software. Copies published by the Free Software Foundation raise funds for GNU development.

リンク：/unix_commands/index [previous]リンク：/unix_commands/index [next]リンク：/cgi-bin/printversion.cgi？tutorial = unix_commands＆file = cpp [Printer Friendly]

Advertisements