alloc_text pragma

Namnger kodavsnittet där de angivna funktionsdefinitionerna placeras. pragma måste ske mellan en funktionsdeklarator och funktionsdefinitionen för de namngivna funktionerna.

Syntax

#pragma alloc_text( "textavsnitt" ,function_1 [,function_2 ... ] )

Anmärkningar

alloc_text pragma hanterar inte C++-medlemsfunktioner eller överlagrade funktioner. Det är endast tillämpligt för funktioner som deklarerats med C-länkning, d.v.s. funktioner som deklarerats med extern "C" länkspecifikation. Om du försöker använda den här pragma på en funktion med C++-länkning genereras ett kompilatorfel.

Eftersom funktionsadressering med hjälp av __based inte stöds kräver det att alloc_textpragmaanvänds för att ange avsnittsplatser. Namnet som anges av textavsnitt ska omges av dubbla citattecken.

alloc_text pragma måste visas efter deklarationerna för någon av de angivna funktionerna och före definitionerna av dessa funktioner.

Funktioner som refereras i en alloc_textpragma ska definieras i samma modul som pragma. Om en odefinierad funktion senare kompileras till ett annat textavsnitt kan felet annars fångas upp. Även om programmet vanligtvis körs korrekt allokeras inte funktionen i de avsedda avsnitten.

Andra begränsningar för alloc_text är följande:

• Det kan inte användas i en funktion.

• Den måste användas när funktionen har deklarerats, men innan funktionen har definierats.

Se även

Pragma-direktiv och nyckelorden __pragma och _Pragma