-
The
#pragma
options
directive
specifies
compiler
options
for
your
source
program.
Syntax
Notes
By
default,
pragma
options
generally
apply
to
the
entire
source
program.
Some
pragmas
must
be
specified
before
any
program
source
statements.
For
the documentation for more information
on pragma options.
To specify more
than one compiler option with the
#pragma options
directive, separate the options using a
blank space. For example:
#pragma
options langlvl=stdc89 halt=s spill=1024 source
Most
#pragma
options
directives
must
come
before
any
statements
in
your
source program; only
comments, blank lines, and other
#pragma
specifications
can
precede
them.
For
example,
the
first
few
lines
of
your
program
can be a comment followed by the
#pragma
options directive:
/* The following is an example of a
#pragma options directive: */
#pragma
options langlvl=stdc89 halt=s spill=1024 source
/* The rest of the source follows ...
*/
Options specified before any code in
your source program apply to your
entire program source code. You can use
other
#pragma
directives
throughout
your
program
to
turn
an
option
on
for
a
selected
block
of
source
code. For example, you can request that
parts of your source code be
included
in your compiler listing:
#pragma
options source
/* Source code between
the source and nosource #pragma
options is included in the compiler listing
*/
#pragma options nosource
The settings in the table below are
valid
options
for
#pragma options
.
For more information, refer to the
pages of the equivalent compiler
option.
Valid settings for
Language
Compiler option
#pragma options
Application
equivalent
option_keyword
align=
option
-q
align
Description
Specifies what
aggregate alignment
rules
the compiler
uses for file
compilation.
Specifies
whether
type-based aliasing
is to be used during
optimization.
Instructs the
compiler to apply
aliasing
assertions
to your compilation
unit.
Produces an
attribute listing
containing
all
names.
[no]ansialias
-q
alias
assert=
option
-q
alias
[no]attr
attr=full
-q
attr
chars=
option
-q
chars
Instructs the
compiler to
treat
See
also
#pragma
all variables of
chars
type char
as either
signed or unsigned.
-q
check
Generates
code
which
performs certain
types of run-time
checking.
When used with
optimization,
reduces code size
where
possible, at
the expense of
execution speed.
[no]check
[no]compact
-q
compact
[no]dbcs
-q
mbcs, dbcs
String literals and
comments
can
contain
multibyte
characters.
[no]dbxextra
-q
dbxextra
Generates symbol
table
information
for unreferenced
variables.
Allows special
digraph and keyword
operators.
Allows the $$
symbol
to be used in the
names of
identifiers.
[no]digraph
-q
digraph
[no]dollar
-q
dollar
enum=
option
-q
enum
Specifies
the
amount
of storage occupied
See
also
#pragma
by
the
enumerations.
enum
-q
flag
Specifies the
minimum
severity
level of diagnostic
messages to be
reported.
Severity levels can
also be
specified
with:
#pragma
options
flag=i =>
#pragma
report
(level,I)
#pragma options
flag=w =>
#pragma
report
(level,W)
#pragma options
flag=e,s,u =>
#pragma
report
(level,E)
flag=
option
float=[no]
option
-q
float
Specifies various
floating
point
options to speed up
or
improve the
accuracy
of
floating
point operations.
[no]flttrap=
option
-q
flttrap
Generates extra
instructions
to
detect and trap
floating
point
exceptions.
Specifies
the path
information stored
for files for dbx
stabstrings.
Stops compiler
when
errors of the
specified
severity
detected.
Specifies search
order for
user
include files.
Allows
the compiler
to perform
optimizations that
assume
errno
is not
modified by system
calls.
Instructs the
compiler to
ignore
certain pragma
statements.
[no]fullpath
-q
fullpath
halt
-q
halt
[no]idirfirst
-q
idirfirst
[no]ignerrno
-q
ignerrno
[no]ignprag
-q
ignprag
[no]info=
option
-q
info
Produces
informational
See
also
#pragma
messages.
info
-q
initauto
Initializes
automatic
storage
to
a
specified
hexadecimal byte
value.
initauto=
value
-q
isolated_call
Specifies functions
isolated_call=
names
in the source file
See
also
#pragma
that
have no side
isolated_call
effects.