Command Reference Guide
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
c
cpp(1) cpp(1)
The lines following appear in the output if and only if name has been the subject of a previ-
ous #define without being the subject of an intervening #undef.
#ifndef name
The lines following do not appear in the output if and only if name has been the subject of a
previous #define without being the subject of an intervening #undef.
#include "filename"
#include <filename>
Include at this point the contents of filename (which are then run through cpp). See the
-I option above for more detail.
#line integer-constant "filename"
Causes cpp to generate line-control information for the next pass of the C compiler.
integer-constant is the line number of the next line and filename is the file where it comes
from. If filename and the quotation marks are omitted, the current file name is unchanged.
#undef name
Cause the definition of name (if any) to be forgotten from now on.
The test directives and the possible
#else directives can be nested. cpp supports names up to 255 char-
acters in length.
EXTERNAL INFLUENCES
Environment Variables
LC_CTYPE determines the interpretation of comments and string literals as single- or multibyte charac-
ters.
LANG determines the language in which messages are displayed.
If LC_CTYPE is not specified in the environment or is set to the empty string, the value of
LANG is used as
a default for each unspecified or empty variable. If
LANG is not specified or is set to the empty string, it
defaults to "C" (see lang(5)). If any internationalization variable contains an invalid setting,
cpp behaves
as if all internationalization variables are set to "C". See environ(5).
International Code Set Support
Single- and multibyte character code sets are supported.
DIAGNOSTICS
Error messages produced by
cpp are intended to be self-explanatory. The line number and filename where
the error occurred are printed along with the diagnostic.
WARNINGS
When newline characters were found in argument lists for macros to be expanded, previous versions of cpp
put out the newlines as they were found and expanded. The current version of cpp replaces these new-
lines with blanks to alleviate problems that the previous versions had when this occurred.
DEPENDENCIES
Series 700
The symbols hp9000s700 and _ _hp9000s700 are not reserved symbols recognized by the
-U option.
They are supplied to
cpp either automatically by the compiler, or by the use of a compiler option. For
example, on a Series 700 system, the command:
cc -v t.c
produces:
/usr/ccs/lbin/cpp t.c /var/tmp/ctmAAAa29220 -D__hp9000s700
-D__hp9000s800
...
(Also see the -D option of the cc command.)
FILES
/usr/include Standard directory for #include files
HP-UX Release 11i: December 2000 − 3 − Section 1−−123
___
___