Compartilhar via


/D (definições de pré-processador)

Define um símbolo de pré-processamento para um arquivo de origem.

/Dname[= | # [{string | number}] ]

Comentários

Você pode usar esse símbolo com #if ou #ifdef para compilar o código-fonte condicionalmente. A definição do símbolo permanecerá em vigor até que uma redefinição é encontrada na fonte ou não o símbolo está definido na fonte usando o #undef diretiva.

/Dtem o mesmo efeito que usar o #define a diretiva no início do arquivo de origem. No entanto, /D retira cotações na linha de comando e #define retém.

Por padrão, o valor associado a um símbolo é 1. Ou seja, /DTEST é equivalente a /DTEST= 1. No exemplo a seguir, a definição de TEST é mostrado para imprimir 1.

Compilando usando /Dname= faz com que o símbolo de não ter um valor associado. Enquanto o símbolo ainda pode ser usado para compilar o código condicionalmente, caso contrário, o símbolo de avalia nada. Por exemplo, no programa de exemplo, a compilação usando /DTEST= causa um erro do compilador. Esse comportamento semelhante usando #define com ou sem um valor.

O comando a seguir define o símbolo DEBUG em Test. c.

CL /DDEBUG  TEST.C

O comando a seguir remove todas as ocorrências da palavra-chave __far in Test. c.

CL /D__far=  TEST.C

É possível definir a variável de ambiente CL para uma seqüência de caracteres que contém um sinal de igual. Para usar /D com a variável de ambiente CL, você deve especificar um sinal de número em vez de um sinal de igual.

SET CL=/DTEST#0

Quando você define um símbolo de pré-processamento no prompt de comando, considere a possibilidade de regras de análise de shell, bem como regras de análise do compilador. Por exemplo, para definir o símbolo de pré-processamento de sinal de um por cento (%) no seu programa, especifique caracteres de sinal de dois por cento (%) na linha de comando. Se você especificar um único sinal de um por cento, um erro de análise é emitido.

CL /DTEST=%% TEST.C

Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio

  1. Abra o projeto Property Pages caixa de diálogo. For more information, see Como: Abrir páginas de propriedades do projeto.

  2. No painel esquerdo, clique em C/C++ e, em seguida, clique em pré-processador.

  3. No painel direito, modifique o Definições do pré-processador propriedade.

Para definir esta opção de compilador programaticamente

Exemplo

// cpp_D_compiler_option.cpp
// compile with: /DTEST
#include <stdio.h>

int main( )
{
    #ifdef TEST
        printf_s("TEST defined %d\n", TEST);
    #else
        printf_s("TEST not defined\n");
    #endif
}
  

Consulte também

Referência

Opções do compilador

Definindo opções do compilador

/ U, /u (cancele símbolos)

The #undef Directive

The #define Directive

Histórico de alterações

Date

History

Motivo

Julho de 2010

Adicionado o que você deve especificar dois "%" símbolos para definir um "%" símbolo de pré-processamento.

Correção de bug de conteúdo.