SmartPascal
$IfDef
Compiler Directive
Executes code if a conditional symbol has been defined
  {$IfDef Symbol}
  ... Code to run when the symbol is defined ...
  {$Else}
  ... Code to run when the symbol is not defined ...
  {$EndIf}
Description
The $IfDef compiler directive starts a section of conditionally compiled code. Only if the specified Symbol has been defined.
 
Symbols come in two types. Predefined in Delphi, such as Console when running a console application. And defined by the $Define compiler direcctive.
 
$IfDef is very useful when developing code, allowing various sections to be compiled when testing.
Related commands
$Define Defines a compiler directive symbol - as used by IfDef
$Else Starts the alternate section of an IfDef or IfNDef
$EndIf Terminates conditional code compilation
$IfNDef Executes code if a conditional symbol has not been defined
$IfOpt Tests for the state of a Compiler directive
$UnDef Undefines a compiler directive symbol - as used by IfDef
 
Example code : Setting up and using a test mode symbol
// Full Unit code.
// -----------------------------------------------------------
// You must store this code in a unit called Unit1 with a form
// called Form1 that has an OnCreate event called FormCreate.
 
unit Unit1;
 
interface
 
uses
  Forms, Dialogs;
 
type
  TForm1 = class(TForm)
    procedure FormCreate(Sender: TObject);
  end;
 
var
  
Form1: TForm1;
 
implementation
{$R *.dfm} // Include form definitions
 
procedure TForm1.FormCreate(Sender: TObject);

var
  text : string;

begin
  // Set our code into test mode
  {$Define TESTMODE}

  text := 'We are in test mode';

  // Display the value of text if we are in test mode
  {$IfDef TESTMODE}
  ShowMessage('text = '+text);
  {$EndIf}

  // Switch off test mode
  {$UnDef TESTMODE}

  // Display the value of text if we are in test mode
  {$IfDef TESTMODE}
  ShowMessage('text = '+text);
  {$Else}
  ShowMessage('Out of test mode now');
  {$EndIf}
end;
 
end.
Hide full unit code
   We are in test mode
   Out of test mode now