Preprocessorrichtlijnen

Preprocessor-instructies, zoals #define en #ifdef, worden gebruikt om bronprogramma's eenvoudig te wijzigen en te compileren in verschillende uitvoeringsomgevingen. Instructies in het bronbestand vertellen de preprocessor om specifieke acties uit te voeren. De preprocessor kan bijvoorbeeld tokens in de tekst vervangen, de inhoud van andere bestanden invoegen in het bronbestand of compilatie van een deel van het bestand onderdrukken door secties met tekst te verwijderen. Preprocessorrichtlijnen worden verwerkt vóór macro-uitbreiding. Als een macro uitbreidt naar iets dat eruitziet als een preprocessoropdracht, wordt deze niet herkend door de preprocessor.

Preprocessorinstructies gebruiken dezelfde tekenset als bronbestandsinstructies, met uitzondering dat escapereeksen niet worden ondersteund. De tekenset die wordt gebruikt in preprocessorinstructies is hetzelfde als de uitvoeringstekenset. De preprocessor herkent ook negatieve tekenwaarden.

De preprocessor herkent de volgende instructies:

#define
#elif
#else
#endif

#error
#if
#ifdef
#ifndef

#import
#include
#line
#warning

#pragma
#undef
#using

Het cijferteken (#) moet het eerste niet-wit-spatieteken op de regel met de instructie zijn. Spatietekens kunnen tussen het cijferteken en de eerste letter van de richtlijn worden weergegeven. Sommige instructies bevatten argumenten of waarden. Tekst die volgt op een richtlijn (met uitzondering van een argument of waarde die deel uitmaakt van de richtlijn) moet worden voorafgegaan door het scheidingsteken voor opmerkingen van één regel (//) of tussen de scheidingstekens voor opmerkingen (/* */). Lijnen met preprocessorrichtlijnen kunnen direct voorafgaand aan het einde van de regelmarkering worden voortgezet met een backslash (\).

Preprocessor-instructies kunnen overal in een bronbestand worden weergegeven, maar ze zijn alleen van toepassing op de rest van het bronbestand, nadat ze zijn weergegeven.

Zie ook

Preprocessoroperators
Vooraf gedefinieerde macro's
preprocessorverwijzing c/c++