Техническая Спецификация для Microchip Technology SW006023-3N
MPLAB
®
XC32 C/C++ Compiler User’s Guide
DS51686E-page 78
2012 Microchip Technology Inc.
3.9.8
Options for Controlling the Preprocessor
The following options control the compiler preprocessor.
TABLE 3-14:
PREPROCESSOR OPTIONS
Option
Definition
-C
Tell the preprocessor not to discard comments. Used with the -E
option.
option.
-dD
Tell the preprocessor to not remove macro definitions into the output,
in their proper sequence.
in their proper sequence.
-Dmacro
Define macro macro with string 1 as its definition.
-Dmacro=defn
Define macro macro as defn. All instances of -D on the command
line are processed before any -U options.
line are processed before any -U options.
-dM
Tell the preprocessor to output only a list of the macro definitions that
are in effect at the end of preprocessing. Used with the -E option.
are in effect at the end of preprocessing. Used with the -E option.
-dN
Like -dD except that the macro arguments and contents are omitted.
Only #
Only #
define name
is included in the output.
-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.
diagnostics are being scanned by a program that does not understand
the column numbers, such as DejaGnu.
-H
Print the name of each header file used, in addition to other normal
activities.
activities.
-I-
Any directories you specify with -I options before the -I- options are
searched only for the case of #include
searched only for the case of #include
“file”. They are not
searched for #include
<file>
.
If additional directories are specified with -I options after the -I-,
these directories are searched for all #include directives. (Ordinarily
all -I directories are used this way.)
In addition, the -I- option inhibits the use of the current directory
(where the current input file came from) as the first search directory for
#include
these directories are searched for all #include directives. (Ordinarily
all -I directories are used this way.)
In addition, the -I- option inhibits the use of the current directory
(where the current input file came from) as the first search directory for
#include
“file”. There is no way to override this effect of -I-.
With -I. you can specify searching the directory that was current
when the compiler was invoked. That is not exactly the same as what
the preprocessor does by default, but it is often satisfactory.
-I-
when the compiler was invoked. That is not exactly the same as what
the preprocessor does by default, but it is often satisfactory.
-I-
does not inhibit the use of the standard system directories for
header files. Thus, -I- and -nostdinc are independent.
-Idir
Add the directory dir to the head of the list of directories to be
searched for header files. This can be used to override a system
header file, substituting your own version, since these directories are
searched before the system header file directories. If you use more
than one -I option, the directories are scanned in left-to-right order.
The standard system directories come after.
searched for header files. This can be used to override a system
header file, substituting your own version, since these directories are
searched before the system header file directories. If you use more
than one -I option, the directories are scanned in left-to-right order.
The standard system directories come after.
-idirafter dir
Add the directory dir to the second include path. The directories on
the second include path are searched when a header file is not found
in any of the directories in the main include path (the one that -I adds
to).
the second include path are searched when a header file is not found
in any of the directories in the main include path (the one that -I adds
to).
-imacros file
Process file as input, discarding the resulting output, before
processing the regular input file. Because the output generated from
the file is discarded, the only effect of -imacros file is to make the
macros defined in file available for use in the main input.
Any -D and -U options on the command line are always processed
before -imacros
processing the regular input file. Because the output generated from
the file is discarded, the only effect of -imacros file is to make the
macros defined in file available for use in the main input.
Any -D and -U options on the command line are always processed
before -imacros
file
, regardless of the order in which they are
written. All the -include and -imacros options are processed in the
order in which they are written.
order in which they are written.