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

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

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

您也可以指定初始化資料 （data_seg）、未初始化的數據 （） 和 const 變數 （bss_segconst_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() {
}

另請參閱

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