The Preprocessor Index

Go Up to C++ Language Guide Index

This section contains C++Builder preprocessor topics.

The preprocessor is a text processor that performs preliminary operations on C and C++ files before they are passed to the compiler. The C++Builder compiler normally invokes the preprocessor in its first pass to convert the text of a source file as part of the first phase of translation. You can also invoke the preprocessor separately, using the command-line preprocessor CPP32.EXE, to process text without compiling. You can use the preprocessor to insert files, conditionally compile code, apply macro substitutions of code, specify compile-time error messages, and apply machine-specific rules to sections of code.

Invoking the C++ Preprocessor

C++ Compiler	Platform	Operation
BCC32C	32-bit Windows	-c- Xclang
BCC32X	32-bit Windows	-E
BCC64	64-bit Windows	-E
BCCIOSARM	32-bit iOS	-E
BCCIOSARM64	64-bit iOS	-E
BCCAARM	Android	-E

Note: For BCC32C some may be accepted and silently ignored.

Invoking the C++ Preprocessor with Command-Line Interfaces of C++ Compilers

Platform	Classic Compiler	Clang Compiler	Operation
32-bit Windows		BCC32C.EXE	cpp32c.exe
		BCC32X.EXE	-E
	BCC32.EXE		cpp32.exe
64-bit Windows		BCC64.EXE	-E
32-bit iOS		BCCIOSARM.EXE	-E
64-bit iOS		BCCIOSARM64.EXE	-E
Android		BCCAARM.EXE	-E

Topics

• Preprocessor Directives
  • # (null_Directive)
  • #include Directive
  • #error Directive
  • #line Directive
  • #import Directive
  • Conditional Compilation Directives
    • Using #if, #elif, #else, and #endif
    • defined Operator
    • Using #ifdef and #ifndef
• Defining and Undefining Macros
  • #define
  • #undef
  • Using The -D And -U Command-line Options
  • Keywords And Protected Words In Macros
  • Token Pasting with the ## Operator
• Macros with Parameters (C++)
• Predefined Macros
• Delphi Compatibility Macros
• Using the '\' Backslash for Line Continuation
• #pragma Directives
  • #pragma alias
  • #pragma alignment
  • #pragma anon_struct
  • #pragma argsused
  • #pragma checkoption
  • #pragma codeseg
  • #pragma comment
  • #pragma defineonoption and #pragma undefineonoption
  • #pragma exit
  • #pragma hdrfile
  • #pragma hdrstop
  • #pragma inline
  • #pragma intrinsic
  • #pragma link
  • #pragma messages
  • #pragma nopushoptwarn
  • #pragmaobsolete
  • #pragma once
  • #pragma option
  • #pragma pack
  • #pragma package
  • #pragma region and #pragma end_region
  • #pragma resource
  • #pragma startup
  • #pragma undefineonoption
  • #pragma warn
• Pseudo-grammar

BCC32X uses Clang command line flags, making it compatible with other Clang-based compilers (BCC32C, BCC64, BCCIOSARM, BCCIOSARM64, and BCCAARM). BCC32C is compatible with the classic compiler flags (BCC32).