Skip to content

The Preprocessor#

Introduction#

Wonkey includes a simple preprocessor that allows you to conditionally compile code depending on a number of build setttings.

The preprocessor supports the following statements: #Import, #If, #Else, #ElseIf, #EndIf, #Rem, #End. Preprocessor statements must begin on a new line.

#Import#

For #Import see the topic Imports.

#Rem .. #End#

For block comments using #Rem and #End see the topic Comments.

#If .. #Else .. #ElseIf .. #EndIf#

Preprocessor expressions may only use the 'And', 'Or' and comparison operators.

The following symbols may be used in preprocessor expressions:

Symbol Type Meaning
__TARGET__ String The current build target. One of:
"windows", "macos", "linux", "raspberry",
"android", "ios", "emscripten"
__CONFIG__ String The current build config. One of: "release", "debug"
__DESKTOP_TARGET__ Bool True if the current build target is windows, macos or linux.
__MOBILE_TARGET__ Bool True if the current build target is android or ios.
__WEB_TARGET__ Bool True if the current build target is emscripten.
__DEBUG__ Bool True if the current build config is debug.
__RELEASE__ Bool True if the current build config is release.

For example, to include code in debug builds only, use something like:

#If __DEBUG__
    Print "This code is only included in debug builds."
#Endif

To include code on desktop or mobile builds, use:

#If __DESKTOP_TARGET__ Or __MOBILE_TARGET__
    Print "This code is only include in desktop and mobile builds."
#Endif