P

Syntax

    -P 

Purpose
Preprocesses the C or C++ source files named in the compiler invocation and creates an output preprocessed source file, file_name.i for each input source file, file_name.c or file_name.C. The -P option calls the preprocessor directly as /usr/vac/exe/xlCcpp.

Notes
The -P option retains all white space including line-feed characters, with the following exceptions:

• All comments are reduced to a single space (unless -C is specified).
• Line feeds at the end of preprocessing directives are not retained.
• White space surrounding arguments to function-style macros is not retained.

#line directives are not issued.

The -P option cannot accept a preprocessed source file, file_name.i as input. Source files with unrecognized filename suffixes are treated and preprocessed as C files, and no error message is generated.

In extended mode, the preprocessor interprets the backslash character when it is followed by a new-line character as line-continuation in:

• macro replacement text
• macro arguments
• comments that are on the same line as a preprocessor directive.

Line continuations elsewhere are processed in ANSI mode only.

The -P option is overridden by the -E option. The -P option overrides the -c, -o, and -qsyntaxonly option. The -C option may used in conjunction with both the -E and -P options.

The default is to compile and link-edit C or C++ source files to produce an executable file.

List of Batch Compiler Options and Their Defaults
Options that Specify Compiler Output
Equivalent Batch Compile-Link and Incremental Build Options