5.8 Pragma Directives

Pragma directives tell the compiler how to treat a certain function, object, or section of code. The C7000 C/C++ compiler supports the following pragmas:

• CALLS (See Section 5.8.1)
• CLINK (See Section 5.8.2)
• CODE_ALIGN (See Section 5.8.4)
• CODE_SECTION (See Section 5.8.5)
• COALESCE_LOOP (See Section 5.8.3)
• DATA_ALIGN (See Section 5.8.6)
• DATA_MEM_BANK (See Section 5.8.7)
• DATA_SECTION (See Section 5.8.8)
• diag_suppress, diag_remark, diag_warning, diag_error, diag_default, diag_push, diag_pop (See Section 5.8.9)
• FORCEINLINE (See Section 5.8.10)
• FORCEINLINE_RECURSIVE (See Section 5.8.11)
• FUNC_ALWAYS_INLINE (See Section 5.8.12)
• FUNC_CANNOT_INLINE (See Section 5.8.13)
• FUNC_EXT_CALLED (See Section 5.8.14)
• FUNC_IS_PURE (See Section 5.8.15)
• FUNC_IS_SYSTEM (See Section 5.8.16)
• FUNC_NEVER_RETURNS (See Section 5.8.17)
• FUNC_NO_GLOBAL_ASG (See Section 5.8.18)
• FUNC_NO_IND_ASG (See Section 5.8.19)
• FUNCTION_OPTIONS (See Section 5.8.20)
• INTERRUPT (See Section 5.8.21)
• LOCATION (See Section 5.8.22)
• MUST_ITERATE (See Section 5.8.23)
• NOINIT (See Section 5.8.24)
• NOINLINE (See Section 5.8.25)
• NO_COALESCE_LOOP (See Section 5.8.26)
• NO_HOOKS (See Section 5.8.27)
• pack (See Section 5.8.28)
• PERSISTENT (See Section 5.8.24)
• PROB_ITERATE (See Section 5.8.29)
• RETAIN (See Section 5.8.30)
• SET_CODE_SECTION (See Section 5.8.31)
• SET_DATA_SECTION (See Section 5.8.31)
• STRUCT_ALIGN (See Section 5.8.32)
• UNROLL (See Section 5.8.33)
• WEAK (See Section 5.8.34)

Most of these pragmas apply to functions. Except for the DATA_MEM_BANK pragma, the arguments func and symbol cannot be defined or declared inside the body of a function. You must specify the pragma outside the body of a function; and the pragma specification must occur before any declaration, definition, or reference to the func or symbol argument. If you do not follow these rules, the compiler issues a warning and may ignore the pragma.

For pragmas that apply to functions or symbols, the syntax differs between C and C++.

• In C, you must supply the name of the object or function to which you are applying the pragma as the first argument. Because the entity operated on is specified, a pragma in C can appear some distance way from the definition of that entity.
• In C++, pragmas are positional. They do not name the entity on which they operate as an argument. Instead, they always operate on the next entity defined after the pragma.