前置處理區 (preprocessor)

對 LPC 編譯器 (compiler) 而言, 前置處理區是程式碼的最前端, 它提供以下便利的特性:

• 共享的定義和程式碼 (#include)
• 巨集 (macros) (#define, #undef)
• 編譯條件 (#if, #ifdef, #ifndef, #else, #elif, #endif)
• 除錯 (#echo)
• 使用特定的編譯器功能 (#pragma)
• 快速的文章格式 (@, @@)

說明:

前面以 # 開頭的命令 (像是 #include), 其 # 符號必須擺在每行的第一個字, 前面不可留有空白.

語法 1 :　　 #include <file.h>

語法 2 :　　 #include "file.h"

語法 1　 的形式, 會在系統的標準引用 (include) 目錄中, 尋找 file.h. (在 TMI 中是 /include)

語法 2　 的形式, 會在程式檔案所在的同一個目錄中, 尋找欲引用的 file.h

語法 1 : #define identifier token_sequence

語法 2 : #define identifier(id_list) token_sequence

慣例上, 程式碼中的 identifier 使用大寫英文字母以強調它們所出現的位置, 並且在程式碼開端或是所引用的表頭檔 (header file)　 中定義其內容.

第二種語法讓 id_list 列出的 identifier 能代換成 token_sequence.

/*　 造出一個有 40 個元素的整數陣列, 並將所有元素的值初始化為其編號的兩倍. 即 stack[0] = 0, stack[1] = 2, stack[2] = 4 ....以此類推. */

#define STACKSIZE 40
#define INITCELL(x) 2*x

int *stack;

create() {

int i;

stack = allocate(STACKSIZE);

for (i = 0; i < STACKSIZE; i++)

stack[i] = INITCELL(i);
}

語法 : #undef identifier

#undef 可以清除一個根本不存在的 identifier.

語法 :

#ifdef <identifier>
#ifndef <identifier>
#if <expression>
#elif <expression>
#else
#endif

　<identifier> 是一個已經定義 (或應該定義) 的 identifier. 它應於您的程式或是已經引用的檔案事先定義, 不然就是驅動程式已定義的符號 (symbol).

　<expression>　 是一個常數運算式 (constant expression), 計算布林 (boolean) 邏輯條件. 運算式中, 可以在合於語法的情形下, 使用下面的組合:

運算子: ||, &&, >>, <<, +, -, *, /, %, &, |, ^, !, ~, ==, !=, <, >, <=, >=, ?:

用來分組的小括號: (, )
呼叫形式: defined(identifier)
以及 identifiers

#ifdef identifier

可以視為這行的縮寫:

#if defined(identifier)
　
#ifndef identifier

可以視為這行的縮寫:

#if !defined(identifier)

#elif expression

可以視為這些的縮寫:

#else
#　 if expression
#　 endif

/* 使用 #if 0　 可以讓你在一段程式碼中加上註解 (comment). 這樣做的其中一個理由是把舊的程式碼保留在原位, 防止新的程式失敗. */

#if 0

/* 在此, 常數運算式算出 (或說本來就是) 0 , 所以此段程式碼不予編譯. */

write(user_name + " 有 " + total_coins + " 元.\n");

#else

/*　 這是另外的情形 (if 算出零值, else 就是非零值), 所以會編譯此段程式. */

printf("%s 有 %d 元\n", user_name, total_coins);

#endif

//　 這個範例由 TMI 的 /adm/simul_efun/system.c 改寫而來.

#ifdef __VERSION
string version() { return __VERSION__; }
#elif defined(MUDOS_VERSION)
string version() { return MUDOS_VERSION; }
#else
#　 if defined(VERSION)
string version() { return VERSION; }
#　 else
string version() { return -1; }
#　 endif
#endif

語法:
#echo This is a message

#echo 這行就是訊息的內容, 並逐字印出. 訊息前後不用加上 ".

語法:
#pragma keyword

• strict_types
• save_binary
• save_types
• warnings
• optimize
• error_context

說明:

• 'strict_types' 告訴編譯器呼叫 call_other() 的函式, 其傳回值不可忽略.
• 　'save_binary' 告訴編譯器要儲存此物件的二進位 (binary) 檔. 在重新啟動或關閉遊戲之後, 載入物件的時間會變快, 因為物件已經儲存為二進位檔, 不必重新編譯.
• 　'save_types' 目前停用
• 　'warnings' 在您的 LPC　 程式碼開啟一些警告措施. 這些警告不見得會依照您預料中的結果反應.
• 　'optimize' 用一點時間改進編譯過的程式碼效率.
• 　'error_context'　 於錯誤訊息中使用更多的文字指示哪一行發生錯誤.

語法 1 :

@marker
<... text block ...>
marker

語法 2 :

@@marker
<... text block ...>
marker

@　　 - 產生一個適於 write() 的字串.

@@　 - 產生一個字串陣列, 適於分頁文章 (body pager).

範例 1 :

int help() {
write( @ENDHELP
這是求助文章。
It's hopelessly inadequate.
ENDHELP
);
return 1;
}

與此相同:

int help() {
write( "這是求助文章。\nIt's hopelessly inadequate.\n" );
return 1;
}

int help() {
this_player()->more( @@ENDHELP
這是求助文章。
It's hopelessly inadequate.
ENDHELP
, 1);
return 1;
}

與底下相同:

int help() {
this_player()->more( ({ "這是求助文章。", "It's hopelessly inadequate." }), 1);
return 1;
}