Replacing text macros

O pré-processador suporta substituição macro texto. -Função como substituto macro de texto também é suportado.

As directivas #define definir o identifier como macro, que é instruir o compilador para substituir todas as ocorrências sucessivas de identifier com replacement-list, que pode ser opcionalmente adicionalmente processado. Se o identificador já está definida como qualquer tipo de macro, o programa é mal-formado.

Objeto como macros substituir cada ocorrência de identifier definido com replacement-list. Versão (1) da directiva #define se comporta exatamente assim.

-Função como macros substituir cada ocorrência de identifier definido com replacement-list, além de tomar uma série de argumentos, que, em seguida, substituir ocorrências correspondentes de qualquer dos parameters no replacement-list. O número de argumentos deve ser o mesmo que o número de argumentos a definição de macros (parameters) ou o programa é mal formado. Se o identificador não está na notação-funcional, isto é, não tem parênteses após si só, não é substituído de todo.

Versão (2) da directiva #define define uma macro-função como simples.

Versão (3) da directiva #define define uma macro-função como com número variável de argumentos. Os argumentos adicionais pode ser acedida utilizando __VA_ARGS__ identificador, o qual é, então, substituído com argumentos, fornecidos com o identificador de ser substituídos.

Versão (4) da directiva #define define uma macro-função como com número variável de argumentos, mas sem argumentos regulares. Os argumentos pode ser acedida apenas com __VA_ARGS__ identificador, o qual é, então, substituído com argumentos, fornecidos com identificador de ser substituídos.

Em função de como macros, um operador de # antes de um identificador na replacement-list corre o identificador através de substituição de parâmetro e encerra o resultado entre aspas, efetivamente criando uma seqüência literal. Além disso, o pré-processador acrescenta backslahes para escapar das aspas literais de cadeia embutidos, se houver, e dobra as barras invertidas dentro da cadeia, se necessário. Todos esquerda e à direita espaço em branco é removida, e qualquer seqüência de espaços em branco no meio do texto (mas não literais de cadeia no interior embutidos) é recolhido em um único espaço. Esta operação é denominada "stringification". Se o resultado da stringification não é uma seqüência válida literal, o comportamento é indefinido.

Um operador de ## entre dois identificadores sucessivas no replacement-list executado a substituição de parâmetro sobre os dois identificadores e então concatena o resultado. Esta operação é chamada de "concatenação" ou "token colando". Apenas fichas que formam um token válido em conjunto pode ser colado: identificadores que formam um longo identificador, dígitos que formam um número ou operadores + e = que formam uma +=. Um comentário não pode ser criado por / colar e * porque os comentários são removidos do texto antes de substituição de macro é considerado. Se o resultado da concatenação não é um token válido, o comportamento é indefinido.

A directiva #undef undefines o identifier, que é cancela definição prévia do identifier pela directiva #define. Se o identificador não têm associado a macro, a directiva é ignorada.

Os nomes de macro a seguir são predefinidos em qualquer unidade de tradução.

Os seguintes nomes de macro adicionais podem ser predefinidos pelas implementações.

Os valores destas macros (excepto para __FILE__ e __LINE__) permanecem constantes em toda a unidade de tradução. Tentativas de redefinir ou indefinir estes resultado macros em um comportamento indefinido.

Nota: no âmbito de cada corpo da função, existe uma função de variável local especial predefinido chamado __func__(desde C++11), definido como uma matriz de caracteres estático com o nome da aplicação, em função do formato definido. Não é uma macro de pré-processamento, mas é usada em conjunto com __FILE__ e __LINE__, eg por 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