alloc_text pragma

Nomeia a seção de código onde as definições de função especificadas são colocadas. O pragma deve ocorrer entre um declarador de função e a definição de função para as funções nomeadas.

Sintaxe

#pragma alloc_text( "seção de texto" ,function_1 [,function_2 ... ] )

Comentários

O alloc_textpragma não lida com funções de membro C++ ou funções sobrecarregadas. É aplicável apenas a funções declaradas com ligação C, ou seja, funções declaradas com a especificação de ligação extern "C". Se você tentar usar esse pragma em uma função com vinculação C++, um erro de compilador será gerado.

Como o endereçamento de função usando __based não é suportado, a especificação de locais de seção requer o uso do alloc_textpragma. O nome especificado por de seção de texto deve ser colocado entre aspas duplas.

O alloc_textpragma deve aparecer após as declarações de qualquer uma das funções especificadas e antes das definições dessas funções.

As funções referenciadas num alloc_textpragma devem ser definidas no mesmo módulo que o pragma. Caso contrário, se uma função indefinida for posteriormente compilada em uma seção de texto diferente, o erro pode ou não ser detetado. Embora o programa geralmente seja executado corretamente, a função não será alocada nas seções pretendidas.

Outras limitações em alloc_text são as seguintes:

• Ele não pode ser usado dentro de uma função.

• Deve ser utilizado depois de a função ter sido declarada, mas antes de a função ter sido definida.

Ver também

diretivas Pragma e as palavras-chave __pragma e _Pragma