code_seg
pragma
指定对象 (.obj) 文件中存储函数的文本节(段)。
语法
#pragma code_seg(
[ "section-name" [,
"section-class" ] ])
#pragma code_seg(
{push
|pop
} [,
标识符 ] [,
“section-name” [,
“section-class” ] ])
参数
push
(可选)将一个记录置于内部编译器堆栈上。 push
可以具有 identifier 和 section-name。
pop
(可选)从内部编译器堆栈的顶部移除记录。 pop
可以具有 identifier 和 section-name。 通过使用 identifier,你只需使用一个 pop
命令即可弹出多条记录。 section-name 在弹出后成为活动文本节名称。
identifier
(可选)当与 push
一起使用时,为内部编译器堆栈上的记录指定名称。 与 pop
一起使用时,此指令会从内部堆栈弹出记录,直到移除 identifier 为止。 如果在内部堆栈上未发现 identifier,则不会弹出任何内容。
"section-name"
(可选)分区的名称。 当与 pop
一起使用时,将弹出堆栈,且 section-name 会成为活动文本节名称。
"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
)、未初始化数据 (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() {
}