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 命令 來快顯多個記錄。 區 段名稱 會在快顯之後變成使用中的文字區段名稱。

identifier
（選擇性）搭配 push 使用 時，會將名稱指派給內部編譯器堆疊上的記錄。 搭配 pop 使用 時，指示詞會從內部堆疊取出記錄，直到 移除識別碼 為止。 如果在 內部堆疊上找不到識別碼，則不會彈出任何識別碼 。

「 section-name 」
（選擇性）區段的名稱。 搭配 pop 使用 時，堆疊會彈出，區 段名稱 會變成使用中的文字區段名稱。

「 section-class 」
（選擇性）忽略，但包含與 2.0 版舊版 Microsoft C++ 的相容性。

備註

物件檔中的區段 是載入記憶體作為單位的資料具名區塊。 文字區段 是包含可執行程式碼的區段。 在本文中，字詞 區段 和 區段 的意義相同。

指示 code_segpragma 詞會指示編譯器將所有後續物件程式碼從轉譯單位放入名為 section-name 的文字區段。 根據預設，物件檔中用於函式的文字區段名為 .text 。 沒有 section-name 參數的指示詞會將後續物件程式碼的文字區段名稱重設為 .text 。 code_segpragma

指示 code_segpragma 詞不會控制針對具現化範本產生的物件程式碼位置。 它也不會控制編譯器隱含產生的程式碼，例如特殊成員函式。 若要控制該程式碼，建議您改用 __declspec(code_seg(...)) 屬性。 它可讓您控制所有物件程式碼的位置，包括編譯器產生的程式碼。

如需不應該用來建立區段的名稱清單，請參閱 /SECTION 。

您也可以指定初始化資料 （ data_seg ）、未初始化的資料 （） 和 const 變數 （ bss_segconst_seg ） 的區段。

您可以使用 DUMPBIN.EXE 應用程式來檢視物件檔案。 每個支援的目標架構的 DUMPBIN 版本都會隨附于 Visual Studio 中。

範例

此範例示範如何使用 code_seg pragma 指示詞來控制放置物件程式碼的位置：

// 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() {
}

另請參閱

code_seg (__declspec)
Pragma 指示詞和 __pragma 和 _Pragma 關鍵字