The C Preprocessor

Last revised July 2000

for GCC version 2

Richard M. Stallman

The C Preprocessor

The C preprocessor is a macro processor that is used automatically by the C compiler to transform your program before actual compilation. It is called a macro processor because it allows you to define macros, which are brief abbreviations for longer constructs.

C 전처리기는 실제로 컴파일 하기 전에 당신의 프로그램이 자동적으로 C 컴파일러에 의해 변형되는 매크로 프로세서 이다. 매크로 프로세서라고도 불리는 이유는 더 긴 구조에 대해 간략한 축약어인 매크로들을 정의 하는 것을 허락하기 때문이다.

The C preprocessor is intended only for macro processing of C, C++ and Objective C source files. For macro processing of other files, you are strongly encouraged to use alternatives like M4, which will likely give you better results and avoid many problems. For example, normally the C preprocessor does not preserve arbitrary whitespace verbatim, but instead replaces each sequence with a single space.

C 전처리기는 오직C, C++ 그리고 객체 C 소스 파일들에서의 매크로 프로세싱만을 위한 것이다. 다른 파일들에 매크로 프로세싱을 위해 당신이 더 좋은 결과와 많은 문제를 피할 수 있도록M4 를 대안으로 사용하기를 강력하게 권장한다. 예를 들어 C 전처리기는 멋대로 공백을 보전하지 않고 대신 하나의 공간으로 각 열들을 교체한다.

For use on C-like source files, the C preprocessor provides four separate facilities that you can use as you see fit:

C-like 소스 파일들에 사용을 위해 C 전처리기는 당신이 적합한 것을 사용할 수 있는 네개의 분리된 편익을 제공한다.:

Inclusion of header files. These are files of declarations that can be substituted into your program.
헤더 파일들 포함. 이것들은 당신의 프로그램으로 대체할 수 있는 선언들의 파일들이다.
Macro expansion. You can define macros, which are abbreviations for arbitrary fragments of C code, and then the C preprocessor will replace the macros with their definitions throughout the program.
매크로 확장. 당신은 C 코드의 멋대로인 파편들을 위한 축약어인 매크로 정의를 할 수 있고 그 다음에 C 전처리기는 프로그램을 통해 그들의 정의로 매크로들을 교체할 것이다.
Conditional compilation. Using special preprocessing directives, you can include or exclude parts of the program according to various conditions.
조건적 컴파일. 특별한 전처리 지시문을 이용해서 당신은 다양한 조건에 따라 프로그램의 부분을 포함시키거다 배제 할 수 있다.
Line control. If you use a program to combine or rearrange source files into an intermediate file which is then compiled, you can use line control to inform the compiler of where each source line originally came from.
라인 조종. 만약 당신이 컴파일 될 intermediate 파일로 소스파일들을 묶거나 재 조정하기 위해서 프로그램을 사용한다면, 당신은 각 소스 라인이 원래 오는 곳에 컴파일을 알리는 라인 조종을 사용할 수 있다.

C preprocessors vary in some details. This manual discusses the GNU C preprocessor, which provides a small superset of the features of ISO Standard C.

C 전처리기는 약간 세부적으로 다양하다. 이 매뉴얼은 ISO 표준 C의 특징을 작은 상위 설정으로 제공하는 GNU C 전처리기를 논의 한다.

In its default mode, the GNU C preprocessor does not do a few things required by the standard. These are features which are rarely, if ever, used, and may cause surprising changes to the meaning of a program which does not expect them. To get strict ISO Standard C, you should use the `-std=c89' or `-std=c99' options, depending on which version of the standard you want. To get all the mandatory diagnostics, you must also use `-pedantic'. See section Invoking the C Preprocessor.

기본 설정에서, GNU C 전처리기는 표준에 요구하는 적은 것들은 하지 않는다. 예상하지 않은 프로그램들의 의미에 놀랄 만한 변화가 거의 드문 것들이 이 것들이다. 엄격한 ISO 표준 C를 위해서 당신은 `-std=c89' 또는 '-std=c99'옵션을 당신이 원하는 표준 버전에서 사용해야만 한다. 모든 수용가능한 진단을 얻으려면 또한 당신은 `-pedantic'을 사용해야만 한다. IInvoking the C Preprocessor 부분을 봐라.

Global Actions: Actions made uniformly on all input files.
Directives: General syntax of preprocessing directives.
Header Files: How and why to use header files.
Macros: How and why to use macros.
Conditionals: How and why to use conditionals.
Assertions: How and why to use assertions.
Line Control: Use of line control when you combine source files.
Other Directives: Miscellaneous preprocessing directives.
Output: Format of output from the C preprocessor.
Implementation: Implementation limits and behavior.
Unreliable Features: Undefined behavior and deprecated features.
Invocation: How to invoke the preprocessor; command options.
Concept Index: Index of concepts and terms.
Index: Index of directives, predefined macros and options.

This document was generated on 27 November 2000 using the texi2html translator version 1.54.