Preprocessor Directives

Preprocessor directives are evaluated in the OScript source code before being compiled. These directives commonly substitute text or perform a conditional compile. OScript supports the following preprocessor directives:

• #define—substitutes the specified values for names during compilation
• #undef—undefines a #define directive
• #ifdef—tests within the preprocessor to see if a specified name is defined
• #ifndef—tests within the preprocessor to see if a specified name is not defined
• #else—else statement used with the #ifdef and #ifndef directives
• #endif—endif statement used with the #ifdef and #ifndef directives

#define

The #define directive substitutes values for names during compilation. They are defined using the syntax:

#define Name Value

The Value substitute may be of any data type or function. For example:

#define ERROR_VALUE5
#define ERROR_MSG"File Not Found"

or

#define CONTENTSFile.Read( myFile )

#undef

The #undef directive undefines a #define token. A token is undefined using the syntax:

#undef identifier

For example:

#undef ERROR_MSG

#ifdef, #ifndef, #else, #endif

The #ifdef, #ifndef, #else, and #endif directives are used together to determine which parts of a script are compiled. These conditional compilation directives allow for code portions to be either compiled or omitted, depending on the stated conditions. These directives use the syntax:

#ifdef identifier
	...block of code...
#else
	...block of code
#endif