Előfeldolgozási irányelvek

Az előprocesszoros direktívákat, például #define és #ifdefazokat arra használják, hogy a forrásprogramok könnyen módosíthatók és lefordíthatóak legyenek különböző végrehajtási környezetekben. A forrásfájlban lévő irányelvek azt mondják az előfeldolgozónak, hogy konkrét műveleteket hajt végre. Az előfeldolgozó például lecserélheti a szöveg jogkivonatait, beszúrhatja más fájlok tartalmát a forrásfájlba, vagy letilthatja a fájl egy részének fordítását a szövegszakaszok eltávolításával. Az előfeldolgozási irányelvek feldolgozása a makróbővítés előtt történik. Ezért ha egy makró egy előfeldolgozási parancsnak tűnő részre bont, az előfeldolgozó nem ismeri fel.

Az előfeldolgozási utasítások ugyanazt a karakterkészletet használják, mint a forrásfájl-utasítások, azzal a kivétellel, hogy a feloldósorozatok nem támogatottak. Az előfeldolgozási utasításokban használt karakterkészlet megegyezik a végrehajtási karakterkészlettel. Az előfeldolgozó a negatív karakterértékeket is felismeri.

Az előfeldolgozó a következő irányelveket ismeri fel:

#define
#elif
#else
#endif

#error
#if
#ifdef
#ifndef

#import
#include
#line
#warning

#pragma
#undef
#using

A számjelnek (#) az irányelvet tartalmazó vonal első nem térközű karakterének kell lennie. A számjel és az irányelv első betűje között szóköz karakterek jelenhetnek meg. Egyes irányelvek argumentumokat vagy értékeket tartalmaznak. Az irányelvet követő szövegeket (kivéve az irányelv részét képező argumentumokat vagy értékeket) az egysoros megjegyzéselválasztónak () kell megelőznie, vagy megjegyzéselválasztókban (///* */) kell lennie. Az előfeldolgozási direktívákat tartalmazó vonalakat úgy lehet folytatni, hogy közvetlenül a vonal vége jelölő előtt egy fordított perjelet (\) helyeznek el.

Az előfeldolgozási irányelvek bárhol megjelenhetnek a forrásfájlban, de csak a forrásfájl többi részére vonatkoznak a megjelenésük után.

Lásd még

Előfeldolgozó operátorok
Előre definiált makrók
c/c++ előfeldolgozási referencia