/ORDER (依順序置放函式)

更新：2007 年 11 月

/ORDER:@filename

參數

/ORDER 選項是告訴 LINK 將某些 COMDAT 以預先決定的順序置入影像，使您的程式最佳化。LINK 會在影像的每一區段中將這些函式依指定的順序放置。

請在 filename 中指定順序，該檔案是一個文字檔 (回應檔)，它列出 COMDAT 的方式就是您希望連結它們的順序。filename 中的每一行都包含一個 COMDAT 的名稱。如果目的檔是以 /Gy 選項編譯便含有 COMDAT。函式名稱須區分大小寫。

LINK 會使用識別項的裝飾形式。編譯器會在建立 .obj 檔時裝飾識別項。當您需要向連結器指定識別項時，請使用 DUMPBIN 工具取得識別項的裝飾形式。如需有關裝飾名稱的詳細資訊，請參閱裝飾名稱。

如果使用了一個以上 /ORDER 規格，只有最後指定的會生效。

利用調整放置順序，您可以將一個函式與該函式所呼叫的函式組成一個群組，進行透過這種交換調整方式，達到程式分頁行為最佳化的結果。您也可以將經常呼叫的函式群組在一起。這些技巧可以增加當您需要呼叫某個函式時它就在記憶體中而不需再從磁碟分頁的可能性。

連結器會在每個 filename 中的裝飾名稱前面加上底線 (_)，除非該名稱是以問號 (?) 或 at 符號 (@) 開頭。例如，假設目的檔含有 extern "C" int func(int) 和 int main(void)，DUMPBIN /SYMBOLS 會列出如下的裝飾名稱：

009 00000000 SECT3  notype ()    External     | _func
00A 00000008 SECT3  notype ()    External     | _main

但是，在順序檔中指定的名稱仍然應該是 func 和 main。

/ORDER 選項會停用累加連結。

注意事項：
LINK 無法為靜態函式排序，因為靜態函式的名稱並非公用符號名稱。指定了 /ORDER 之後，連結器會對順序檔中每一個靜態或找不到的符號發出 LNK4037 警告。