CKTIS / C++
Флаг за функционалност и конфигурация по време на компилация
Флагът при компилация избира вариант на програмата при изграждане. Флагът при изпълнение променя поведението на вече изградена програма.
Версия: ISO C++23; implementation support may vary
Синтаксис
#ifndef CKTIS_ENABLE_TRACE
#define CKTIS_ENABLE_TRACE 0
#endif
#if CKTIS_ENABLE_TRACE
// C++ declarations or statements included when the flag is 1.
#endif
// Alternative for selecting between C++ statements:
constexpr bool use_trace = CKTIS_ENABLE_TRACE != 0;
// Inside a function: if constexpr (use_trace) { /* ... */ }Флаг за функционалност, зададен при изграждане, определя какво се компилира. Промяната на стойността му изисква засегнатите части да се изградят отново. За разлика от него настройка при изпълнение, например стойност от конфигурационен файл, може да управлява обикновен if без повторна компилация. Флагът не заменя проверките на правата за достъп.
Уговори CKTIS_ENABLE_TRACE да има стойност 0 или 1 и използвай #ifndef, за да зададеш 0 по подразбиране, ако макросът не е дефиниран. #if CKTIS_ENABLE_TRACE проверява стойността; #ifdef CKTIS_ENABLE_TRACE проверява само дали макросът е дефиниран и затова условието е изпълнено дори при 0. Пропуснатият код не се анализира синтактично като C++. Използвай #if, когато трябва да изключиш незадължителен заглавен файл или декларация.
За избор между инструкции на C++ използвай constexpr bool с if constexpr. Препроцесорът не може да прочете стойността на променлива на C++ в #if. И двата клона на if constexpr се анализират синтактично; извън шаблон компилаторът проверява и отхвърления клон. При инстанциране на шаблон отхвърленият клон не се инстанцира, ако условието вече не зависи от стойност на параметър на шаблона.
В ISO C++23 макросите __cpp_* и __cpp_lib_* показват поддръжка на възможности на езика или библиотеката, а не дали проектът е решил да ги използва. Поддръжката може да се различава според реализацията. Преди проверка на библиотечен макрос включи <version> или съответния заглавен файл и сравни стойността с изискваната ревизия. Задавай еднакви стойности на флаговете, които влияят на споделени дефиниции в заглавни файлове, във всички единици за транслация, които ги използват: различни дефиниции на една и съща функция inline могат да нарушат правилото за една дефиниция (ODR). Изгради и тествай и двата варианта.
Примери
#include <iostream>
#ifndef CKTIS_ENABLE_TRACE
#define CKTIS_ENABLE_TRACE 0
#endif
#if CKTIS_ENABLE_TRACE
void trace_startup() {
std::cout << "trace: enabled\n";
}
#endif
int main() {
#if CKTIS_ENABLE_TRACE
trace_startup();
#endif
std::cout << "ready\n";
}
Резултат
ready
По подразбиране програмата извежда само `ready`. Изгради я отново с `CKTIS_ENABLE_TRACE=1`, за да се изведе `trace: enabled` на реда преди `ready`. При `0` препроцесорът пропуска както дефиницията на `trace_startup`, така и извикването ѝ.
Свързани уроци
- C++ · Урок 60 · Напреднало · Версия: 3