#pragma OPTION: Additional Options

Compilation Unit or until next pragma OPTION

  #pragma OPTION (ADD [<Handle>]{<Option>}|DEL ({Handle}|ALL)) 
  

None

<Handle>: This identifier allows selective deletion of added options.

<Option>: A valid option string enclosed in double quote (") characters

None

This pragma allows the addition of options inside the source code during file compilation.

Use the ADD command to add additional options to the current options. A handle may be given optionally.

Use the DEL command to remove all options with a specific handle or use the ALL keyword to remove all options.

All keywords and the handle are case-sensitive.

Restrictions:

• The -D: Macro Definition (preprocessor definition) compiler option is not allowed. Use a " #define" preprocessor directive instead.
• The -OdocF: Dynamic Option Configuration for Functions compiler option is not allowed. Specify this option on the command line or in a configuration file instead.
• The Message Setting compiler options have no effect:
  • -WmsgSd: Setting a Message to Disable
  • -WmsgSe: Setting a Message to Error
  • -WmsgSi: Setting a Message to Information
  • -WmsgSw: Setting a Message to Warning

    Use #pragma MESSAGE: Message Setting instead.

• Only options concerning tasks during code generation are used. Options controlling the preprocessor, for example, have no effect.
• No macros are defined for specific options.
• Only options having function scope may be used.
• The given options must not specify a conflict to any other given option.
• The pragma is not allowed inside declarations or definitions.

The following example illustrates compiling a single function with the additional -Or option.

#pragma OPTION ADD function_main_handle "-Or"
int sum(int max) { /* compiled with -or */

  int i, sum=0;

  for (i = 0; i < max; i++) {

    sum += i;

  }

  return sum;

}

#pragma OPTION DEL function_main_handle

/* now the same options as before the #pragma */

/* OPTION ADD are active again */

The following listing shows improper uses of the OPTION pragma.

#pragma OPTION ADD -Or /* ERROR, use "-Or" */
#pragma OPTION  "-Or" /* ERROR, use keyword ADD */

#pragma OPTION ADD "-Odocf=\"-Or\"" 

/* ERROR, "-Odocf" not allowed in this pragma */

void f(void) {

#pragma OPTION ADD "-Or"

/* ERROR, pragma not allowed inside of declarations */

}

#pragma OPTION ADD "-Cni"

#ifdef __CNI__ 
/* ERROR, macros are not defined for options */

/* added with the pragma */

#endif