Conditional Compilation

The following directives may be used to mark sections of code to be conditionally compiled, based on whether a symbol, variable or label has been defined, or whether a constant expression is true or false. They are analogous to the IF/ELSEIF/ELSE/ENDIF statements except that they affect the operation of the compiler—determining which statements are compiled and which are ignored—rather than the runtime interpreter. The feature requires compiler switch /RC or /X:1 or higher.

Directive	Description
++IF, ++ELIF	Conditionals based on evaluating a constant expression.
++IFDEF, ++IFNDEF, ++ELIFDEF	Conditionals based on whether the specified symbol or structure has been previously defined.
++IFLBL, ++INFLBL, ++ELIFLBL	Conditionals based on whether specified label has been defined.
++IFMAP, ++IFNMAP, ++ELIFMAP	Conditionals based on whether specified variable has been mapped.
++ELSE	Used as an optional final clause preceded by any other type of ++IFxxx and ++ELIFxxx statements. The lines following the ++ELSE up to the ++ENDIF are compiled only if all of the preceding clauses were false.
++ENDIF	Marks the end of the conditional construct.

Example 1

++IFDEF GUI

PROGRAM MYPROG,1.0G(100)

++ELSE

PROGRAM MYPROG,1.0(100)

++ENDIF

The above illustrates one way to use conditional compilation to conditionally create either a GUI or text version of your RUN file, starting from the same source file. Previously you could only do the same thing with runtime conditions (which may still be a better option in most cases), but in some cases, you may prefer to have two separate versions of the RUN (perhaps to keep the size down, or to simplify runtime debugging.) Note that the symbol GUI would have had to have been defined somewhere prior to the compiler seeing these statements; see below for how to define symbols on the command line.

Also note that we used two different versions of the PROGRAM statement in the above example, so that you can easily tell which RUN version you have by displaying it with DIR/V.

Example 2

++IF APPVER = 1

++MESSAGE Compiling Version 1

++ver1.bsi

++ELIF APPVER = 2

++MESSAGE Compiling Version 2

++ver2.bsi

++ELSE

++ERROR No APPVER defined!

++ENDIF

This illustrates the IF/ELIF/ELSE/ENDIF construct, used to select which ++INCLUDE file to use based on the defined APPVER. See the ???? and ++++ERROR statements.

Example 3

++IFDEF SBX

++PRAGMA SBX

++ENDIF

This illustrates a simple way to allow a single source file to be compiled as either an SBX or a RUN file. The SBX symbol would need to be defined on the compiler command line, e.g. COMPIL MYPROG/X:2/C:SBX=1.

Example 4

++IFDEF MODE_SBX

++PRAGMA SBX

++ELIFDEF MODE_LIT

++PRAGMA FORCE_FSPEC SYS:MYPROG.LIT

++ELSE

++ENDIF

This illustrates an approach to generating either an SBX, LIT, or RUN from the same source file. The MODE_SBX or MODE_LIT symbols would need to be defined on the compiler command line, e.g. COMPIL MYPROG/X:2/C:MODE_SBX=1.