Warum nur ein Makro definieren, wenn es noch nicht definiert ist?

In unserer gesamten C-Codebasis sehe ich jedes Makro wie folgt definiert:

#ifndef BEEPTRIM_PITCH_RATE_DEGPS
#define BEEPTRIM_PITCH_RATE_DEGPS                   0.2f
#endif

#ifndef BEEPTRIM_ROLL_RATE_DEGPS
#define BEEPTRIM_ROLL_RATE_DEGPS                    0.2f
#endif

#ifndef FORCETRIMRELEASE_HOLD_TIME_MS
#define FORCETRIMRELEASE_HOLD_TIME_MS               1000.0f
#endif

#ifndef TRIMSYSTEM_SHEARPIN_BREAKINGFORCE_LBS
#define TRIMSYSTEM_SHEARPIN_BREAKINGFORCE_LBS       50.0f
#endif

Was ist der Grund dafür, diese Definitionsprüfungen durchzuführen, anstatt nur die Makros zu definieren?

#define BEEPTRIM_PITCH_RATE_DEGPS                   0.2f
#define BEEPTRIM_ROLL_RATE_DEGPS                    0.2f
#define FORCETRIMRELEASE_HOLD_TIME_MS               1000.0f
#define TRIMSYSTEM_SHEARPIN_BREAKINGFORCE_LBS       50.0f

Ich kann diese Praxis nirgendwo im Internet erklärt finden.

Dadurch können Sie die Makros beim Kompilieren überschreiben:

gcc -DMACRONAME=value

Als Voreinstellung werden die Definitionen in der Header-Datei verwendet.

Wie ich im Kommentar sagte, stellen Sie sich diese Situation vor:

foo.h

#define FOO  4

def.h

#ifndef FOO
#define FOO 6
#endif

#ifndef BAR
#define BAR 4
#endif

bar.c

#include "foo.h"
#include "defs.h"

#include <stdio.h>

int main(void)
{
    printf("%d%d", FOO, BAR);
    return 0;
}

Wird gedruckt 44.

Wenn jedoch die Bedingung ifndef nicht vorhanden war, würde das Ergebnis Kompilierungswarnungen der MACRO-Neudefinition sein und es wird gedruckt 64.

$ gcc -o bar bar.c
In file included from bar.c:2:0:
defs.h:1:0: warning: "FOO" redefined [enabled by default]
 #define FOO 6
 ^
In file included from bar.c:1:0:
foo.h:1:0: note: this is the location of the previous definition
 #define FOO 4
 ^

Ich kenne den Kontext nicht, aber dies kann verwendet werden, um dem Benutzer die Möglichkeit zu geben, die von diesen Makrodefinitionen festgelegten Werte zu überschreiben. Wenn der Benutzer explizit einen anderen Wert für eines dieser Makros definiert, wird dieser anstelle der hier verwendeten Werte verwendet.

Beispielsweise können Sie in g++ die verwenden -D Flag während der Kompilierung, um einen Wert an ein Makro zu übergeben.

Dies geschieht, damit der Benutzer der Header-Datei die Definitionen aus seinem/ihrem Code oder aus dem -D-Flag des Compilers überschreiben kann.

Jedes C-Projekt befindet sich in mehreren Quelldateien. Wenn Sie an einer einzelnen Quelldatei arbeiten, scheinen (und tatsächlich) die Prüfungen keinen Sinn zu haben, aber wenn Sie an einem großen C-Projekt arbeiten, ist es eine gute Praxis, nach vorhandenen Definitionen zu suchen, bevor Sie eine Konstante definieren. Die Idee ist einfach: Sie benötigen die Konstante in dieser bestimmten Quelldatei, aber sie wurde möglicherweise bereits in einer anderen definiert.

Sie könnten über ein Framework / eine Bibliothek nachdenken, die dem Benutzer eine Standardvoreinstellung gibt, die es dem Benutzer ermöglicht, sie zu kompilieren und daran zu arbeiten. Diese Definitionen sind in verschiedenen Dateien verteilt und dem Endbenutzer wird empfohlen, seine config.h-Datei einzuschließen, in der er seine Werte konfigurieren kann. Wenn der Benutzer einige Definitionen vergessen hat, kann das System aufgrund der Voreinstellung weiterarbeiten.

Verwenden

#ifndef BEEPTRIM_PITCH_RATE_DEGPS
#define BEEPTRIM_PITCH_RATE_DEGPS                   0.2f
#endif

ermöglicht dem Benutzer, den Wert des Makros mit dem Befehlszeilenargument zu definieren (in gcc/clang/VS) -DBEEPTRIM_PITCH_RATE_DEGPS=0.3f.

Es gibt noch einen weiteren wichtigen Grund. Es ist ein Fehler, ein Präprozessormakro anders neu zu definieren. Siehe diese Antwort auf eine andere SO-Frage. Ohne das #ifndef check, sollte der Compiler einen Fehler erzeugen, wenn -DBEEPTRIM_PITCH_RATE_DEGPS=0.3f wird als Befehlszeilenargument beim Compileraufruf verwendet.