Pragma Details

This section describes each Compiler-available pragma. The pragmas are listed in alphabetical order and are divided into separate tables. The following table lists and defines the topics that appear in the description of each pragma.

Table 1. Pragma documentation topics
Topic Description
Scope Scope of pragma where it is valid. (See below.)
Syntax Specifies the syntax of the pragma in an EBNF format.
Synonym Lists a synonym for the pragma or none, if a synonym does not exist.
Arguments Describes and lists optional and required arguments for the pragma.
Default Shows the default setting for the pragma or none.
Description Provides a detailed description of the pragma and how to use it.
Example Gives an example of usage and effects of the pragma.
See also Names related sections.

The following table is a description of the different scopes for pragmas.

Table 2. Definition of items that can appear in a pragma's scope topic
Scope Description
File The pragma is valid from the current position until the end of the source file. For example, if the pragma is in a header file included from a source file, the pragma is not valid in the source file.
Compilation Unit The pragma is valid from the current position until the end of the whole compilation unit. For example, if the pragma is in a header file included from a source file, it is valid in the source file too.
Data Definition The pragma affects only the next data definition. Ensure that you always use a data definition behind this pragma in a header file. If not, the pragma is used for the first data segment in the next header file or in the main file.
Function Definition The pragma affects only the next function definition. Ensure that you use this pragma in a header file: The pragma is valid for the first function in each source file where such a header file is included if there is no function definition in the header file.
Next pragma with same name The pragma is used until the same pragma appears again. If no such pragma follows this one, it is valid until the end of the file.