Table of Contents

1. The C Preprocessor

1.1 Transformations Made Globally

1.2 Preprocessing Directives

1.3 Header Files

1.3.1 Uses of Header Files

1.3.2 The `#include' Directive

1.3.3 How `#include' Works

1.3.4 Once-Only Include Files

1.3.5 Inheritance and Header Files

1.4.1 Simple Macros

1.4.2 Macros with Arguments

1.4.3 Predefined Macros

1.4.3.1 Standard Predefined Macros

1.4.3.2 Nonstandard Predefined Macros

1.4.4 Stringification

1.4.5 Concatenation

1.4.6 Undefining Macros

1.4.7 Redefining Macros

1.4.8 Pitfalls and Subtleties of Macros

1.4.8.1 Improperly Nested Constructs

1.4.8.2 Unintended Grouping of Arithmetic

1.4.8.3 Swallowing the Semicolon

1.4.8.4 Duplication of Side Effects

1.4.8.5 Self-Referential Macros

1.4.8.6 Separate Expansion of Macro Arguments

1.4.8.7 Cascaded Use of Macros

1.4.9 Newlines in Macro Arguments

1.5 Conditionals

1.5.1 Why Conditionals are Used

1.5.2 Syntax of Conditionals

1.5.2.1 The `#if' Directive

1.5.2.2 The `#else' Directive

1.5.2.3 The `#elif' Directive

1.5.3 Keeping Deleted Code for Future Reference

1.5.4 Conditionals and Macros

1.5.5 Assertions

1.5.6 The `#error' and `#warning' Directives

1.6 Combining Source Files

1.7 Miscellaneous Preprocessing Directives

1.8 C Preprocessor Output

1.9 Invoking the C Preprocessor

Index of Directives, Macros and Options

This document was generated by GCC Administrator on March, 17 2001 using texi2html