/D (Präprozessordefinitionen)

Artikel
06/09/2015

Definiert ein Vorverarbeitungssymbol für eine Quelldatei.

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

Hinweise

Sie können dieses Symbol mit #if oder #ifdef zur bedingten Kompilierung von Quellcode verwenden. Die Symboldefinition bleibt bestehen, bis sie im Code neu definiert wird oder ihre Definition im Code durch die #undef-Direktive aufgehoben wird.

/D erzielt denselben Effekt wie die #define-Direktive am Anfang einer Quellcodedatei, wobei jedoch /D die Anführungszeichen in der Befehlszeile entfernt und #define sie beibehält.

Standardmäßig wird einem Symbol der Wert 1 zugeordnet. /Dname entspricht beispielsweise /Dname**=1**. In dem Beispiel am Ende dieses Artikels wird dargestellt, wie bei der Definition von TEST der Wert 1 ausgegeben wird.

Beim Kompilieren mithilfe von /Dname**=** wird dem Symbol kein Wert zugeordnet. Obwohl das Symbol trotzdem zur bedingten Codekompilierung verwendet werden kann, ergibt das Symbol keinen Wert. Wenn Sie zum Beispiel mithilfe von /DTEST= kompilieren, tritt ein Fehler auf. Dieses Verhalten ähnelt der Verwendung von #define mit oder ohne Wert.

Dieser Befehl definiert das DEBUG-Symbol in TEST.C:

CL /DDEBUG TEST.C

Mit dem folgenden Befehl werden alle Vorkommen des Schlüsselworts __far aus TEST.C entfernt.

CL /D__far= TEST.C

Sie können die Umgebungsvariable CL nicht für eine Zeichenfolge festlegen, die ein Gleichheitszeichen enthält. Wenn Sie /D zusammen mit der Umgebungsvariablen CL verwenden möchten, geben Sie ein Nummernzeichen anstelle eines Gleichheitszeichens an.

SET CL=/DTEST#0

Wenn Sie ein Vorverarbeitungssymbol an der Eingabeaufforderung definieren, sollten Sie Compileranalyseregeln sowie Shell-Analyseregeln berücksichtigen. Wenn Sie beispielsweise im Programm ein Vorverarbeitungssymbol für ein Prozentzeichen (%) definieren möchten, geben Sie an der Eingabeaufforderung zwei Prozentzeichen (%%) ein: Bei Angabe von nur einem Zeichen wird ein Analysefehler ausgegeben.

CL /DTEST=%% TEST.C

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen finden Sie unter Gewusst wie: Öffnen von Projekteigenschaftenseiten.
Wählen Sie im linken Bereich die Optionen Konfigurationseigenschaften, C/C++, Präprozessor aus.
Wählen Sie im rechten Bereich in der rechten Spalte der Eigenschaft Präprozessordefinitionen im Dropdownmenü die Option Bearbeiten aus.
Gehen Sie im Dialogfeld Präprozessordefinitionen folgendermaßen vor: Fügen Sie (zeilenweise) eine oder mehrere Definitionen hinzu bzw. ändern oder löschen Sie eine oder mehrere Definitionen. Klicken Sie auf OK, um die Änderungen zu speichern.

So legen Sie diese Compileroption programmgesteuert fest

Siehe PreprocessorDefinitions.

Beispiel

// 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
}

Siehe auch

Referenz

Compileroptionen

Festlegen von Compileroptionen

/U, /u (Symboldefinitionen aufheben)

#undef-Direktive (C/C++)

#define-Direktive (C/C++)

Freigeben über