Replacing text macros

Le prprocesseur prend en charge le remplacement macro de texte. Fonction macro-like remplacement de texte est galement pris en charge .

Les directives #define dfinir la identifier comme macro, c'est indiquer au compilateur de remplacer toutes les occurrences successives de identifier avec replacement-list, qui peuvent tre ventuellement transforms en outre. Si l'identificateur est dj dfinie comme tout type de macro, le programme est mal form .

Objet de type macros remplacer toutes les occurrences de identifier dfini avec replacement-list. Version (1) de la directive #define se comporte exactement comme a .

Fonction de type macros remplacer chaque occurrence de identifier dfini avec replacement-list, en plus de prendre un certain nombre d'arguments, qui a ensuite remplacer les occurrences correspondantes de toute la parameters dans le replacement-list. Le nombre d'arguments doit tre le mme que le nombre d'arguments dans la dfinition macro (parameters) ou le programme est mal form. Si l'identifiant n'est pas dans la notation fonctionnelle, c'est dire ne pas avoir parenthses aprs lui-mme, il n'est pas remplac tous .

Version (2) de la directive #define dfinit une fonction simple de type macro .

Version (3) de la directive #define dfinit une macro de type fonction avec un nombre variable d'arguments. Les arguments complmentaires peuvent tre accds en utilisant identifiant __VA_ARGS__, qui est ensuite remplac par des arguments, fournis avec l'identifiant soit remplac .

Version (4) de la directive #define dfinit une macro de type fonction avec un nombre variable d'arguments, mais aucun argument rguliers. Les arguments peuvent tre accds seulement avec identifiant __VA_ARGS__, qui est ensuite remplac par des arguments, fournis avec identifiant doit tre remplac .

En fonction de type macros, un oprateur # avant un identificateur dans le replacement-list fonctionne l'identifiant grce au remplacement des paramtres et enferme le rsultat entre guillemets, crant ainsi une chane littrale. En outre, le prprocesseur ajoute backslahes d'chapper les guillemets entourant les chanes littrales intgres, le cas chant, et double les anti-slash dans la chane si ncessaire. Tous les espaces initiaux et finaux est enlev, et toute squence d'espaces dans le milieu du texte (mais pas les littraux de chane incorpors l'intrieur) est rduit un seul espace. Cette opration est appele "La mise en chane". Si le rsultat de La mise en chane n'est pas une chane valide littral, le comportement est indfini .

Un oprateur ## entre deux identificateurs successifs dans le replacement-list court remplacement de paramtres sur les deux identifiants, puis concatne le rsultat. Cette opration est appele concatnation ou jeton coller". Seuls les jetons qui forment ensemble un jeton valide peut tre coll: identificateurs qui forment un identifiant plus, des chiffres qui forment un certain nombre d'oprateurs, ou + et = qui forment un +=. Un commentaire ne peut pas tre cr par / coller et * parce que les commentaires sont supprims partir du texte avant la substitution macro est pris en compte. Si le rsultat de la concatnation n'est pas un jeton valide, le comportement est indfini .

La directive #undef annule la dfinition du identifier, qui annule la dfinition prcdente du identifier par la directive #define. Si l'identificateur de ne pas avoir associ macro, la directive est ignore .

Les noms des macros suivantes sont prdfinies dans une unit de traduction .

Les noms suivants macro supplmentaires peuvent tre prdfinis par les implmentations .

Les valeurs de ces macros (sauf pour __FILE__ et __LINE__) reste constante tout au long de l'unit de traduction. Les tentatives visant redfinir ou annuler la dfinition de ces macros rsultat en un comportement indfini .

Remarque: dans le cadre de tous les corps de la fonction, il ya une fonction spciale variable locale prdfinie nomme __func__ (depuis C++11), dfini comme un tableau de caractres statique contenant le nom de la fonction dans la mise en uvre dfini par format. Ce n'est pas une macro du prprocesseur, mais il est utilis conjointement avec __FILE__ et __LINE__, par exemple, par assert .

#include <iostream>

//make function factory and use it
#define FUNCTION(name, a) int fun_##name() { return a;}

FUNCTION(abcd, 12);
FUNCTION(fff, 2);
FUNCTION(kkk, 23);

#undef FUNCTION
#define FUNCTION 34
#define OUTPUT(a) std::cout << #a << '\n'

int main()
{
    std::cout << "abcd: " << fun_abcd() << '\n';
    std::cout << "fff: " << fun_fff() << '\n';
    std::cout << "kkk: " << fun_kkk() << '\n';
    std::cout << FUNCTION << '\n';
    OUTPUT(million);               //note the lack of quotes
}

abcd: 12
fff: 2
kkk: 23
34
million