Partilhar via


bss_seg pragma

Especifica a seção (segmento) em que variáveis não inicializadas são armazenadas no arquivo objeto (.obj).

Sintaxe

#pragma bss_seg( [ "section-name" [ , "section-class" ] ] )
#pragma bss_seg(pushpop | { } [ , identificador ] [ , "nome da seção" [ , "classe da seção" ] ])

Parâmetros

push
(Opcional) Coloca um registro na pilha interna do compilador. Um push pode ter um identificador e um section-name.

pop
(Opcional) Remove um registro da parte superior da pilha interna do compilador. Um pop pode ter um identificador e um section-name. Você pode exibir vários registros usando apenas um comando pop com o identificador. O section-name se torna o nome da seção BSS ativo após o pop.

identificador
(Opcional) Quando usado com push, atribui um nome ao registro na pilha interna do compilador. Quando usado com pop, a diretiva remove registros da pilha interna até que o identificador seja removido. Se o identificador não for encontrado na pilha interna, nada será exibido.

"section-name"
(Opcional) O nome de uma seção. Quando usada com pop, a pilha é exibida e section-name se torna o nome ativo da seção BSS.

"section-class"
(Opcional) Ignorado, mas incluído para compatibilidade com versões do Microsoft C++ anteriores à versão 2.0.

Comentários

Uma seção em um arquivo-objeto é um bloco de dados nomeado carregado na memória como uma unidade. Uma seção BSS é uma seção que contém dados não inicializados. Neste artigo, os termos segmento e seção têm o mesmo significado.

A diretiva bss_segpragma informa ao compilador para colocar todos os itens de dados não inicializados da unidade de tradução em uma seção do BSS chamada nome da seção. Em alguns casos, o uso de bss_seg pode reduzir o tempo de carregamento, agrupando dados não inicializados em uma mesma seção. Por padrão, a seção BSS usada para dados não inicializados em um arquivo de objeto se chama .bss. Uma diretiva bss_segpragma sem um parâmetro section-name redefine o nome da seção BSS para os itens de dados não inicializados subsequentes para .bss.

Os dados alocados com bss_segpragma não retêm nenhuma informação sobre o respectivo local.

Para uma lista de nomes que não devem ser usados para criar uma seção, confira /SECTION.

Você também pode especificar seções para dados inicializados (data_seg), funções (code_seg) e variáveis const (const_seg).

Você pode usar o aplicativo DUMPBIN.EXE para exibir arquivos-objeto. As versões de DUMPBIN para cada arquitetura de destino com suporte estão incluídas no Visual Studio.

Exemplo

// pragma_directive_bss_seg.cpp
int i;                     // stored in .bss
#pragma bss_seg(".my_data1")
int j;                     // stored in .my_data1

#pragma bss_seg(push, stack1, ".my_data2")
int l;                     // stored in .my_data2

#pragma bss_seg(pop, stack1)   // pop stack1 from stack
int m;                     // stored in .my_data1

int main() {
}

Confira também

Pragmadiretivas e as __pragma palavras-chave e _Pragma