Шпаргалка по макросам и директивам препроцессора Си (cpp)

Краткий справочник по синтаксису препроцессора Си (cpp), который можно запускать автономно или в составе цепочки сборки C/C++.

Автономный препроцессинг

Запуск препроцессора напрямую без вызова полного компилятора:

# -P подавляет вывод маркеров строк
cpp -P source.c > preprocessed.c

Включение заголовочных файлов

#include <stdio.h>      /* Системные заголовки и стандартная библиотека */
#include "my_header.h"  /* Локальные заголовки проекта */

Определение макросов

#define BUFFER_SIZE 1024
#define PI 3.1415926535

/* Отмена определения макроса */
#undef BUFFER_SIZE

Функциональные макросы

#define MIN(a, b) (((a) < (b)) ? (a) : (b))
#define DEG_TO_RAD(x) ((x) * 0.0174532925)

Преобразование в строку (#)

Одиночный оператор # преобразует параметры макроса в строковые литералы:

#define STR(name) #name
#define PRINT_VAR(x) printf("%s = %d\n", #x, x)

char *var_name = STR(my_object);  /* → "my_object" */

Слияние токенов (##)

Двойной оператор ## соединяет два токена в один идентификатор:

#define COMMAND(NAME) { #NAME, NAME ## _command }

struct command commands[] = {
  COMMAND(quit),   /* → { "quit", quit_command } */
  COMMAND(help)    /* → { "help", help_command } */
};

Условная компиляция

#ifdef DEBUG
  #define LOG(msg) printf("[DEBUG] %s\n", msg)
#elif defined(VERBOSE)
  #define LOG(msg) printf("[INFO] %s\n", msg)
#else
  #define LOG(msg) /* noop */
#endif

/* Защита от повторного включения (Include guards) */
#ifndef MY_HEADER_H
#define MY_HEADER_H

/* объявления здесь */

#endif /* MY_HEADER_H */

Диагностика и предупреждения

#if __STDC_VERSION__ < 201112L
  #warning "C11 features are not fully enabled"
#endif

#if !defined(REQUIRED_CONFIG)
  #error "REQUIRED_CONFIG must be defined before compilation"
#endif

Стандартные предопределенные макросы

__FILE__: Имя текущего исходного файла в виде строки.
__LINE__: Текущий номер строки в виде целого числа.
__DATE__: Дата компиляции в виде строки (Mmm dd yyyy).
__TIME__: Время компиляции в виде строки (hh:mm:ss).