Admin at 19:37, 12 February 2013

2013-02-12T19:37:54Z

Admin: Created page with "= Action = Conditional compilation directives intended for conditional compilation.
2013-02-12T19:37:30Z

Created page with "= Action = Conditional compilation directives intended for conditional compilation. Action =

Conditional compilation directives intended for conditional compilation.

 

 

= Syntax =

<nowiki>#</nowiki>IF condition

 

<nowiki>#</nowiki>ELSEIF condition

 

<nowiki>#</nowiki>ELSE

 

<nowiki>#</nowiki>ENDIF

 

 

= Remarks =

Conditional compilation is supported by the compiler.

What is conditional compilation?

Conditional compilation will only compile parts of your code that meet the criteria of the condition.

 

By default all your code is compiled.

 

Conditional compilation needs a [http://avrhelp.mcselec.com/const.htm constant] to test.

So before a condition can be tested you need to define a constant.

 

CONST test = 1

<nowiki>#</nowiki>IF TEST

    Print "This will be compiled"

<nowiki>#</nowiki>ELSE

    Print "And this not"

<nowiki>#</nowiki>ENDIF

 

[[File:Notice.jpg|left|Notice.jpg]] Note that there is no THEN and that <nowiki>#</nowiki>ENDIF is not <nowiki>#</nowiki>END IF (no space)

 

You can nest the conditions and the use of <nowiki>#</nowiki>ELSE and <nowiki>#</nowiki>ELSEIF is optional.

 

There are a few internal constants that you can use. These are generated by the compiler:

_CHIP = 0

_RAMSIZE = 128

_ERAMSIZE = 128

_SIM = 0

_XTAL = 4000000

_BUILD = 11162

 

_CHIP is an integer that specifies the chip, in this case the 2313

_RAMSIZE is the size of the SRAM

_ERAMSIZE is the size of the EEPROM

_SIM is set to 1 when the $SIM directive is used

_XTAL contains the value of the specified crystal

_BUILD is the build number of the compiler.

 

The build number can be used to write support for statements that are not available in a certain version :

<nowiki>#</nowiki>IF _BUILD >= 11162

 s = Log(1.1)

<nowiki>#</nowiki>ELSE

Print "Sorry, implemented in 1.11.6.2"

<nowiki>#</nowiki>ENDIF

 

Conditional compilation allows you to create different versions of your program but that you keep one source file.

For example you could make a multi lingual program like this :

 

CONST LANGUAGE=1

 

'program goes here

 

<nowiki>#</nowiki>IF LANGUAGE=1

DATA "Hello"

<nowiki>#</nowiki>ENDIF

<nowiki>#</nowiki>IF LANGUAGE=2

DATA "Guten tag"

<nowiki>#</nowiki>ENDIF

 

By changing the just one constant you then have for example English or German data lines.

 

 

Conditional compilation does not work with the $REGFILE directive. If you put the $REGFILE inside a condition or not, the compiler will use the first $REGFILE it encounters. This will be changed in a future version.

 

A special check was added to 1.11.8.1 to test for existence of constants or variables.

<nowiki>#</nowiki>IF varexist("S")

      'the variable S was dimensioned so we can use it here

<nowiki>#</nowiki>ELSE

   'when it was not dimmed and we do need it, we can do it here

  DIM S as BYTE

<nowiki>#</nowiki>ENDIF

 

 

= See Also =

[[CONST]]

 {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 41: / Line 41: @@
 <span style="font-family: Arial;">&nbsp;</span>
-Conditional compilation needs a&nbsp;[http://avrhelp.mcselec.com/const.htm constant]&nbsp;to test.
+Conditional compilation needs a&nbsp;[[CONST|constant]]&nbsp;to test.
 So before a condition can be tested you need to define a constant.