====== The Preprocessor ======

The preprocessor is an unique feature of the X# compiler. In the Clipper times, the preprocessor was used to implement the commands (they were mapped to function calls), and in the VO times the preprocessor was present, but very few people used it.

The simpliest statement is the #ifdef, usable for conditional compilation, and very helpful in the migration from VO:
<code>#ifdef __XSHARP__
  super:__FocusPage( int( nIndex ) )
#else	
  super:__FocusPage( nIndex )
#endif</code>

Now, in the X# compiler it is again a very powerful tool. It can be used to implement commands for compatibility with xBase languages like Clipper, FoxPro and Harbour:
<code>#command USE <db>     ;
     [VIA <rdd>]        ;
     [ALIAS <a>]        ;
     [<sh:SHARED>]      ;
     [<ex:EXCLUSIVE>]           ;
     [<ro:READONLY>]            ;
     [<nw:NEW>]         ;
    ;
    => DBUseArea(<.nw.>, <rdd>, <(db)>, <(a)>, iif(<.sh.> .or. <.ex.>, !<.ex.>, FALSE), <.ro.>)</code>
to be used like this:
<code>USE "C:\dbf\customer.dbf" VIA "DBFCDX" ALIAS test</code>
Source: [[https://www.xsharp.info/forum/public-chit-chat/561-managed-dbf-using-x-language?start=12|https://www.xsharp.info/forum/public-chit-chat/561-managed-dbf-using-x-language?start=12]] - the second message by Chris Pyrgas

The development team has ported a Harbour app to X# using the preprocessor to translate the way @x,y SAY...GET  commands to their own function calls, making it work without changing the original code.

But it can also be used to write less code for MVVM ViewModels:
<code>#command PROPERTY <n> AS <t> GETSET <v> NOTIFY CHANGE =>;
PROPERTY <n> AS <t>;;
GET;;
RETURN SELF:<v>;;
END GET;;
SET;;
IF SELF:<v> <> VALUE;;
SELF:<v> := VALUE;;
SELF:NotifyPropertyChanged(<"n">);;
ENDIF;;
END SET;;
END PROPERTY </code>
and to be used like this:
<code>PROPERTY x AS INT SET _x NOTIFY CHANGE</code>
Source: [[https://www.xsharp.info/forum/pearls/216-snippets-in-vs-2017-rc-some-success?start=5|https://www.xsharp.info/forum/pearls/216-snippets-in-vs-2017-rc-some-success?start=5]] - first and second message by Johan Nel.

You can find the full documentation here:

[[https://www.xsharp.info/help/x-preprocessor-directives.html|https://www.xsharp.info/help/x-preprocessor-directives.html]]