code_seg
pragma
指定函式儲存在物件 (.obj) 檔案中的文字區段(區段)。
語法
#pragma code_seg(
[ “section-name” [,
“section-class” ] ])
#pragma code_seg(
{push
|pop
} [,
identifier ] [,
“section-name” [,
“section-class” ] ])
參數
push
(選擇性)將記錄放在內部編譯程式堆疊上。 push
可以有標識碼和區段名稱。
pop
(選擇性)從內部編譯程式堆疊頂端移除記錄。 pop
可以有標識碼和區段名稱。 您可以使用識別碼,只使用一個pop
命令來快顯多個記錄。 區 段名稱 會在快顯之後變成使用中的文字區段名稱。
識別碼
(選擇性)搭配 push
使用 時,會將名稱指派給內部編譯程式堆疊上的記錄。 搭配 pop
使用 時,指示詞會從內部堆疊取出記錄,直到 移除標識符 為止。 如果在 內部堆疊上找不到標識符,則不會彈出任何標識符 。
“section-name”
(選擇性)區段的名稱。 搭配 pop
使用 時,堆疊會彈出,區 段名稱 會變成使用中的文字區段名稱。
“section-class”
(選擇性)忽略,但包含與 2.0 版之前版本Microsoft C++相容性。
備註
對象檔中的區段是載入記憶體作為單位的數據具名區塊。 文字區段是包含可執行程式碼的區段。 在本文中,字詞 區段 和 區段 的意義相同。
指示 code_seg
pragma 詞會指示編譯程式將所有後續物件程式代碼從轉譯單位放入名為 section-name 的文字區段。 根據預設,物件檔中用於函式的文字區段名為 .text
。 沒有 section-name 參數的指示詞會將後續物件程式代碼的文字區段名稱重設為 。code_seg
pragma.text
指示 code_seg
pragma 詞不會控制針對具現化範本產生的物件程序代碼位置。 它也不會控制編譯程式隱含產生的程序代碼,例如特殊成員函式。 若要控制該程式代碼,建議您改用 __declspec(code_seg(...))
屬性。 它可讓您控制所有物件程序代碼的位置,包括編譯程式產生的程序代碼。
如需不應該用來建立區段的名稱清單,請參閱 /SECTION
。
您也可以指定初始化資料 (data_seg
)、未初始化的數據 () 和 const 變數 (bss_seg
const_seg
) 的區段。
您可以使用 DUMPBIN.EXE 應用程式來檢視物件檔。 每個支援的目標架構的 DUMPBIN 版本都會隨附於 Visual Studio 中。
範例
此範例示範如何使用 code_segpragma 指示詞來控制放置物件程式代碼的位置:
// pragma_directive_code_seg.cpp
void func1() { // stored in .text
}
#pragma code_seg(".my_data1")
void func2() { // stored in my_data1
}
#pragma code_seg(push, r1, ".my_data2")
void func3() { // stored in my_data2
}
#pragma code_seg(pop, r1) // stored in my_data1
void func4() {
}
int main() {
}