alloc_text
pragma
Noemt de codesectie waarin de opgegeven functiedefinities worden geplaatst. De pragma moet plaatsvinden tussen een functiedeclaratie en de functiedefinitie voor de benoemde functies.
Syntaxis
#pragma alloc_text(
'tekstsectie',
function_1 [,
function_2 ... ])
Opmerkingen
De alloc_text
pragma verwerkt geen C++-lidfuncties of overbelaste functies. Het is alleen van toepassing op functies die zijn gedeclareerd met C-koppeling, dat wil gezegd, functies die zijn gedeclareerd met de extern "C"
koppelingsspecificatie. Als u probeert deze pragma te gebruiken voor een functie met C++-koppeling, wordt er een compilerfout gegenereerd.
Omdat functieadressering met __based
niet wordt ondersteund, is het gebruik van de alloc_text
pragmavereist voor het opgeven van sectielocaties. De naam die is opgegeven door tekstsectie moet tussen dubbele aanhalingstekens worden geplaatst.
De alloc_text
pragma moet worden weergegeven na de declaraties van een van de opgegeven functies en vóór de definities van deze functies.
Functies waarnaar wordt verwezen in een alloc_text
pragma moeten worden gedefinieerd in dezelfde module als de pragma. Als een niet-gedefinieerde functie later wordt gecompileerd in een andere tekstsectie, kan de fout al dan niet worden opgevangen. Hoewel het programma meestal correct wordt uitgevoerd, wordt de functie niet toegewezen in de beoogde secties.
Andere beperkingen voor alloc_text
zijn als volgt:
Het kan niet worden gebruikt binnen een functie.
Deze moet worden gebruikt nadat de functie is gedeclareerd, maar voordat de functie is gedefinieerd.