Навіщо визначати макрос лише якщо він ще не визначений?

У всій нашій базі коду С я бачу, що кожен макрос визначається наступним чином:

#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

Яке обгрунтування робити ці перевірки визначення, а не просто визначати макроси?

#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

Я не можу знайти цю практику, пояснену в Інтернеті.

Це дозволяє замінити макроси під час компіляції:

gcc -DMACRONAME=value

Визначення у файлі заголовка використовуються за замовчуванням.

Як я вже говорив у коментарі, уявіть собі таку ситуацію:

foo.h

#define FOO  4

defs.h

#ifndef FOO
#define FOO 6
#endif

#ifndef BAR
#define BAR 4
#endif

бар. c

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

#include <stdio.h>

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

Буде друкувати 44.

Однак, якщо умовного ifndefне було, результатом будуть попередження про компіляцію перевизначення MACRO, і воно надрукується 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
 ^

Я не знаю контексту, але це може бути використано, щоб надати користувачеві можливість замінити значення, встановлені цими визначеннями макросів. Якщо користувач явно визначає інше значення для будь-якого з цих макросів, воно буде використано замість значень, використаних тут.

Наприклад, у g ++ ви можете використовувати -Dпрапор під час компіляції, щоб передати значення макросу.

Це робиться для того, щоб користувач файлу заголовка міг змінити визначення з його / її коду або з прапора компілятора -D.

Будь-який проект С розміщений на декількох вихідних файлах. Під час роботи над одним вихідним файлом перевірки, здається, (і насправді) не мають сенсу, але при роботі над великим проектом С добрею практикою є перевірка наявних визначень, перш ніж визначати константу. Ідея проста: вам потрібна константа у цьому конкретному вихідному файлі, але, можливо, вона вже була визначена в іншому.

Ви можете подумати про фреймворк / бібліотеку, яка надає користувачеві стандартну настройку, яка дозволяє користувачеві компілювати та працювати над ним. Ці визначення поширюються у різних файлах, і кінцевому користувачеві рекомендується включити файл config.h, де він може налаштувати його значення. Якщо користувач забув дещо визначити, система може продовжувати працювати через попередньо встановлену.

Використання

#ifndef BEEPTRIM_PITCH_RATE_DEGPS
#define BEEPTRIM_PITCH_RATE_DEGPS                   0.2f
#endif

дозволяє користувачеві визначити значення макросу за допомогою аргументу командного рядка (у gcc / clang / VS) -DBEEPTRIM_PITCH_RATE_DEGPS=0.3f .

Є ще одна важлива причина. Помилковим є повторне визначення макросу препроцесора інакше. Дивіться цю відповідь на інше питання SO . Без #ifndefперевірки компілятор повинен створювати помилку, якщо -DBEEPTRIM_PITCH_RATE_DEGPS=0.3fвін використовується як аргумент командного рядка у виклику компілятора.