Техническая Спецификация для Microchip Technology SW006023-3N

Скачать
Страница из 238
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.
-dD
Tell the preprocessor to not remove macro definitions into the output, 
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.
-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.
-dN
Like -dD except that the macro arguments and contents are omitted. 
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.
-H
Print the name of each header file used, in addition to other normal 
activities.
-I-
Any directories you specify with -I options before the -I- options are 
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
 
“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-
 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.
-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). 
-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
 
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.