Free Pascal编译器中常见的预定义

在Lazarus交流群中看见有人提出有关判断CPU架构问题，我把官方文档的链接发了过去。为了方便在未来更多使用Free Pascal的中文开发者使用，故撰写这篇文章用于整理资料。

官方文档请参见：Compiler defines during compilation

Free Pascal中提供了很多编译期间的符号，可以在编译时进行判断，来让程序在不同平台上表现出不同的行为。

系统环境 链接到标题

架构 链接到标题

Free Pascal还定义了一些符号来判断处理器的架构。例如，如果目标处理器是x86_64，那么会定义CPUX86_64。

   {$IFDEF CPUX86_64}
   // 这里的代码只在x86_64架构上执行
   {$ENDIF}

表格 G.2: 使用 FPC 编译时可能的 CPU 定义

操作系统 链接到标题

Free Pascal也定义了一些符号来判断目标操作系统。例如，如果目标操作系统是Windows，那么会定义MSWINDOWS。

   {$IFDEF MSWINDOWS}
   // 这里的代码只在Windows操作系统上执行
   {$ENDIF}

表格 G.4: 使用目标操作系统编译时可能的定义

编译器信息 链接到标题

表格 G.1: 使用 FPC 编译时可能的定义

调试模式 链接到标题

在 Free Pascal 中，{$IFOPT} 指令可以用于检查特定编译器开关的状态。如果该开关处于指定状态，则会编译其后的文本。如果该开关不处于指定状态，则编译会在对应的 {$ELSE} 或 {$ENDIF} 指令后继续。

例如，如果你想检查是否处于调试模式，可以使用以下代码：

{$IFOPT D+}
  writeln('调试模式已激活');
{$ENDIF}

在上述代码中，如果编译器的调试模式开关（D+）已打开，那么 writeln('调试模式已激活'); 这行代码就会被编译。否则，这行代码会被忽略。

此外，你还可以在代码的开始部分添加以下代码，以便在 IDE 的调试模式下自动定义 DEBUG：

{$IFOPT D+}
  {$DEFINE DEBUG}
{$ENDIF}

这样，当你从 IDE 中以调试模式运行应用程序时，DEBUG 就会被定义。你可以在代码的其他部分使用 {$IFDEF DEBUG} 来检查 DEBUG 是否已被定义。例如：

{$IFDEF DEBUG}
  writeln('DEBUG 已定义');
{$ENDIF}

在上述代码中，如果 DEBUG 已被定义，那么 writeln('DEBUG 已定义'); 这行代码就会被编译。否则，这行代码会被忽略。这样，你就可以根据是否定义了 DEBUG 来决定是否编译某些代码，从而实现在调试模式下执行特定的代码。