Cx51 User's Guide

Directives

The C51 Compiler provides a number of directives you may use to control source file compilation. Directives are composed of one or more letters or digits and, unless otherwise specified, may be specified after the filename on the command line or within the source file using #pragma. For example:

C51 testfile.c SYMBOLS CODE DEBUG

or

#pragma SYMBOLS CODE DEBUG

The source file to compile is testfile.c and SYMBOLS, CODE, and DEBUG are the directives.

Control directives may be divided into three groups:

• Source controls define macros on the command line and determine the name of the file to be compiled.
• Object controls affect the form and content of the generated object module (*.OBJ). These directives allow you to specify the optimizing level or include debugging information in the object file.
• Listing controls govern various aspects of the listing file (*.LST), in particular its format and specific content.

Note

• The syntax is the same for the command line and #pragma. Multiple options, however, may be specified on the #pragma line.
• Some directives may be specified only once at the beginning of a source file. If one of these directives is specified more than once, the compiler generates a fatal error and aborts compilation.