C Präprozessor

C-Präprozessor (CPP)ist eine unabhängige Phase im Kompilierungsprozess, inVor der eigentlichen KompilierungTextverarbeitung des Quellcodes. Zu den Hauptfunktionen gehören:

  • Makroerweiterung
  • Dateieinbindung
  • Bedingte Kompilierung
  • Behandlung spezieller Direktiven

C-PräprozessorEr ist kein Bestandteil des Compilers, sondern ein separater Schritt im Kompilierungsprozess.

Kurz gesagt, der C-Präprozessor ist nichts weiter als ein Textersetzungswerkzeug, das den Compiler anweist, die erforderliche Vorverarbeitung vor der eigentlichen Kompilierung durchzuführen.

Wir werden den C-Präprozessor als CPP abkürzen.

Alle Präprozessor-Befehle beginnen mit einem Hash-Zeichen#Der Anfang. Es muss das erste Nicht-Leerzeichen sein. Aus Gründen der Lesbarkeit sollten Präprozessor-Direktiven in der ersten Spalte beginnen.

Alle wichtigen Präprozessor-Direktiven sind unten aufgeführt:

Direktive Beschreibung Anwendungsbeispiele
#define Makros definieren (symbolische Konstanten oder funktionsähnliche Makros) #define PI 3.14159
#define MAX(a,b) ((a) > (b) ? (a) : (b))
#include Header-Dateien einbinden #include <stdio.h>
#include "myheader.h"
#undef Ein Makro undefinieren #undef PI
#ifdef Den folgenden Code kompilieren, wenn das Makro definiert ist #ifdef DEBUG
printf("Debug info\n");
#endif
#ifndef Wenn das Makro nicht definiert ist, den nachfolgenden Code kompilieren (häufig verwendet für Header-Dateischutz) #ifndef HEADER_H
#define HEADER_H
/* content */
#endif
#if Bedingte Kompilierung (kann mit dem defined-Operator verwendet werden) #if VERSION > 2
/* new version code */
#endif
#else #if/#ifdef/#ifndefder alternative Zweig #ifdef WIN32
/* Windows代码 */
#else
/* other systems */
#endif
#elif Ähnlich wie else if #if defined(UNIX)
/* Unix代码 */
#elif defined(WIN32)
/* Windows代码 */
#endif
#endif Bedingten Kompilierungsblock beenden Wie im obigen Beispiel gezeigt
#error Einen Kompilierungsfehler erzeugen und eine Meldung ausgeben #if !defined(C99)
#error "需要C99标准"
#endif
#pragma Compilerspezifische Direktiven (nicht standardisiert, von Compiler zu Compiler unterschiedlich) #pragma once
#pragma pack(1)

Präprozessor-Beispiele

Analysiere die folgenden Beispiele, um die verschiedenen Direktiven zu verstehen.

#define MAX_ARRAY_LENGTH 20

Diese Direktive weist CPP an, MAX_ARRAY_LENGTH als 20 zu definieren. Verwende#defineDefiniere Konstanten, um die Lesbarkeit zu verbessern.

#include <stdio.h>
#include "myheader.h"

Diese Direktiven weisen CPP an,Systembibliothekstdio.h daraus zu beziehen und den Text zur aktuellen Quelldatei hinzuzufügen. Die nächste Zeile weist CPP an, es aus dem lokalen Verzeichnismyheader.hzu beziehen und den Inhalt zur aktuellen Quelldatei hinzuzufügen.

#undef  FILE_SIZE
#define FILE_SIZE 42

Diese Direktive weist CPP an, das definierte FILE_SIZE aufzuheben und es als 42 zu definieren.

#ifndef MESSAGE
   #define MESSAGE "You wish!"
#endif

Diese Direktive weist CPP an, MESSAGE nur zu definieren, wenn MESSAGE nicht definiert ist.

#ifdef DEBUG
   /* Your debugging statements here */
#endif

Diese Direktive weist CPP an, die Verarbeitungsanweisungen auszuführen, wenn DEBUG definiert ist. Zur Kompilierungszeit, wenn du den Schalter an den gcc-Compiler übergibst,-DDEBUGist diese Direktive sehr nützlich. Sie definiert DEBUG, und du kannst das Debugging jederzeit während der Kompilierung aktivieren oder deaktivieren.

Beispiel

#include <stdio.h>

// Definiere ein Konstantenmakro
#define PI 3.1415926
#define GREETING "Hello, World!"

// Definiere ein funktionsähnliches Makro (beachte die Verwendung von Klammern)
#define SQUARE(x) ((x) * (x))
#define MAX(a, b) ((a) > (b) ? (a) : (b))

// Beispiel für bedingte Kompilierung
#define DEBUG 1

int main() {
    // Verwendung konstanter Makros
    printf("Der Wert von PI: %f\n", PI);
    printf("%s\n", GREETING);
   
    // Verwendung funktionsähnlicher Makros
    int x = 5;
    printf("%d zum Quadrat ist: %d\n", x, SQUARE(x));
    printf("Der größere Wert von 3 und 5 ist: %d\n", MAX(3, 5));
   
    // Beispiel für bedingte Kompilierung
    #ifdef DEBUG
    printf("[Debug-Info] Programm hat die main-Funktion erreicht\n");
    #endif
   
    // Compiler-Versionsprüfung
    #if __STDC_VERSION__ >= 201112L
    printf("C11-Standard wird verwendet\n");
    #elif __STDC_VERSION__ >= 199901L
    printf("C99-Standard wird verwendet\n");
    #else
    printf("C89/C90-Standard wird verwendet\n");
    #endif
   
    // Beispiel für die Error-Direktive (Aufheben der Auskommentierung verursacht einen Kompilierfehler)
    // #error "Dies ist ein manuell ausgelöster Fehler"
   
    return 0;
}

Empfehlungen für bewährte Verfahren

  1. Makro-Benennung:

    • Verwenden Sie für Makronamen ausschließlich Großbuchstaben und Unterstriche
    • Beispiel:#define MAX_SIZE 100
  2. Hinweise zu funktionsähnlichen Makros:

    • Jeder Parameter und der gesamte Ausdruck sollten in Klammern eingeschlossen werden.
    • Vermeiden Sie Argumente mit Nebenwirkungen (z. B.SQUARE(x++))
  3. Header-Dateischutz:

    #ifndef MY_HEADER_H
    #define MY_HEADER_H
    /* 头文件内容 */
    #endif
  4. Debugging der bedingten Kompilierung:

    #ifdef DEBUG
    #define DEBUG_PRINT(fmt, ...) printf(fmt, ##__VA_ARGS__)
    #else
    #define DEBUG_PRINT(fmt, ...)
    #endif
    
  5. Plattformübergreifende Entwicklung:

    #if defined(_WIN32)
    // Windows特定代码
    #elif defined(__linux__)
    // Linux特定代码
    #elif defined(__APPLE__)
    // macOS特定代码
    #endif
    

Vordefinierte Makros

ANSI C definiert viele Makros. Sie können diese Makros in der Programmierung verwenden, aber Sie können diese vordefinierten Makros nicht direkt ändern.

MakroBeschreibung
__DATE__Aktuelles Datum, eine Zeichenkonstante im Format "MMM DD YYYY".
__TIME__Aktuelle Uhrzeit, eine Zeichenkonstante im Format "HH:MM:SS".
__FILE__Dies enthält den aktuellen Dateinamen, eine Zeichenkettenkonstante.
__LINE__Dies enthält die aktuelle Zeilennummer, eine Dezimalkonstante.
__STDC__Definiert als 1, wenn der Compiler gemäß dem ANSI-Standard kompiliert.

Probieren wir das folgende Beispiel aus:

Beispiel

#include <stdio.h> /** Demonstrationsprogramm für vordefinierte Makros * Demonstriert gängige vordefinierte Makros im ANSI-C-Standard und ihre Verwendung*/ int main() { // Aktuellen Quelldateinamen ausgeben (Zeichenkettenkonstante) printf("Aktuelle Datei: %s\n", __FILE__); // Kompilierungsdatum ausgeben (Format "MMM DD YYYY") printf("Kompilierungsdatum: %s\n", __DATE__); // Kompilierungszeit ausgeben (Format "HH:MM:SS") printf("Kompilierungszeit: %s\n", __TIME__); // Aktuelle Zeilennummer ausgeben (dezimaler Ganzzahlwert) printf("Aktuelle Zeilennummer: %d\n", __LINE__); // Prüfen, ob es dem ANSI/ISO-Standard entspricht (1 bedeutet konform) printf("ANSI-Standard: %d\n", __STDC__); // Praktisches Beispiel: Ausgabe von Debug-Informationen printf("\n[Debug-Info] %s (Zeile %d) kompiliert am %s %s\n", __FILE__, __LINE__, __DATE__, __TIME__); return 0; }

Wenn der obige Code (in der Dateitest.c) kompiliert und ausgeführt wird, liefert er die folgenden Ergebnisse:

当前文件: predef_macros.c
编译日期: Jul 5 2023
编译时间: 14:30:45
当前行号: 13
ANSI标准: 1

[调试信息] predef_macros.c (第16行) 编译于 Jul 5 2023 14:30:45

Präprozessoroperatoren

Der C-Präprozessor stellt die folgenden Operatoren bereit, die Ihnen beim Erstellen von Makros helfen:

Makro-Fortsetzungsoperator (\)

Ein Makro wird normalerweise in einer einzelnen Zeile geschrieben. Wenn ein Makro zu lang ist, um in eine einzelne Zeile zu passen, verwenden Sie den Zeilenfortsetzungsoperator (\). Zum Beispiel:

#define  message_for(a, b)  \
    printf(#a " and " #b ": We love you!\n")

Stringizing-Operator (#)

Wenn Sie in einer Makrodefinition einen Makroparameter in eine Zeichenfolgenkonstante umwandeln müssen, verwenden Sie den Stringizing-Operator (#). Der in einem Makro verwendete Operator hat einen bestimmten Parameter oder eine Parameterliste. Zum Beispiel:

Beispiel

#include <stdio.h> #define message_for(a, b) \ printf(#a " and " #b ": We love you!\n") int main(void) { message_for(Carole, Debra); return 0; }

Wenn der obige Code kompiliert und ausgeführt wird, liefert er die folgenden Ergebnisse:

Carole and Debra: We love you!

Token-Pasting-Operator (##)

Der Token-Pasting-Operator (##) in einer Makrodefinition führt zwei Parameter zusammen. Er ermöglicht, dass zwei separate Token in der Makrodefinition zu einem Token zusammengeführt werden. Zum Beispiel:

Beispiel

#include <stdio.h> #define tokenpaster(n) printf ("token" #n " = %d", token##n) int main(void) { int token34 = 40; tokenpaster(34); return 0; }

Wenn der obige Code kompiliert und ausgeführt wird, liefert er die folgenden Ergebnisse:

token34 = 40

So kommt es dazu, denn dieses Beispiel erzeugt die folgende tatsächliche Ausgabe des Compilers:

printf ("token34 = %d", token34);

Dieses Beispiel zeigt, dass token##n zu token34 verkettet wird; hier haben wirStringizing-Operator (#)undToken-Pasting-Operator (##) verwendet。

Der defined()-Operator

PräprozessordefinedDer Operator wird in konstanten Ausdrücken verwendet, um zu bestimmen, ob ein Bezeichner bereits mit #define definiert wurde. Wenn der angegebene Bezeichner definiert ist, ist der Wert wahr (ungleich null). Wenn der angegebene Bezeichner nicht definiert ist, ist der Wert falsch (null). Das folgende Beispiel zeigt die Verwendung des defined()-Operators:

Beispiel

#include <stdio.h> #if !defined (MESSAGE) #define MESSAGE "Schön wär's!" #endif int main(void) { printf("Hier ist die Nachricht: %s\n", MESSAGE); return 0; }

Wenn der obige Code kompiliert und ausgeführt wird, liefert er die folgenden Ergebnisse:

Here is the message: You wish!

Parametrisierte Makros

Eine leistungsstarke Eigenschaft von CPP ist die Möglichkeit, parametrisierte Makros zu verwenden, um Funktionen zu simulieren. Zum Beispiel berechnet der folgende Code das Quadrat einer Zahl:

int square(int x) {
   return x * x;
}

Wir können den obigen Code mit einem Makro wie folgt umschreiben:

#define square(x) ((x) * (x))

Bevor Sie ein Makro mit Parametern verwenden, müssen Sie die Direktive#defineverwenden, um es zu definieren. Die Parameterliste ist in Klammern eingeschlossen und muss unmittelbar auf den Makronamen folgen. Zwischen dem Makronamen und der linken Klammer ist kein Leerzeichen erlaubt. Zum Beispiel:

Beispiel

#include <stdio.h> #define MAX(x,y) ((x) > (y) ? (x) : (y)) int main(void) { printf("Max zwischen 20 und 10 ist %d\n", MAX(10, 20)); return 0; }

Wenn der obige Code kompiliert und ausgeführt wird, liefert er die folgenden Ergebnisse:

Max between 20 and 10 is 20
Weitere Erweiterungen