CKTIS / C++
Flag de funcionalidade e configuração em tempo de compilação
Uma flag de compilação seleciona a variante do programa a construir. Uma flag de execução altera o comportamento de um programa já construído.
Versão: ISO C++23; implementation support may vary
Sintaxe
#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) { /* ... */ }Uma flag de funcionalidade definida durante a construção determina o que é compilado. Alterar o seu valor exige voltar a construir as partes afetadas. Já uma definição em tempo de execução, como um valor lido de um ficheiro de configuração, pode controlar um if normal sem recompilação. Uma flag não substitui as verificações de autorização.
Limita CKTIS_ENABLE_TRACE aos valores 0 e 1 e usa #ifndef para lhe atribuir 0 por omissão quando a macro não está definida. #if CKTIS_ENABLE_TRACE testa o valor; #ifdef CKTIS_ENABLE_TRACE apenas testa se a macro está definida e, por isso, é verdadeiro mesmo com 0. O código omitido não é analisado sintaticamente como C++. Usa #if para excluir um cabeçalho opcional ou uma declaração.
Para escolher entre instruções de C++, usa um constexpr bool com if constexpr. O pré-processador não consegue ler o valor de uma variável de C++ em #if. Ambos os ramos de if constexpr são analisados sintaticamente; fora de um template, o compilador verifica também o ramo descartado. Ao instanciar um template, o ramo descartado não é instanciado se a condição já não depender de um valor do template.
Em ISO C++23, as macros __cpp_* e __cpp_lib_* indicam o suporte de funcionalidades da linguagem ou da biblioteca, não a decisão do projeto de as utilizar. O suporte pode variar consoante a implementação. Antes de testar uma macro de biblioteca, inclui <version> ou o cabeçalho correspondente e compara o seu valor com a revisão necessária. Mantém coerentes as flags que afetam definições partilhadas em cabeçalhos em todas as unidades de tradução que as usam: definições diferentes da mesma função inline podem violar a regra da definição única (ODR). Constrói e testa ambas as variantes.
Exemplos
#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";
}
Resultado
ready
Por omissão, o programa apresenta apenas `ready`. Volta a construí-lo com `CKTIS_ENABLE_TRACE=1` para apresentar `trace: enabled` na linha anterior a `ready`. Com `0`, o pré-processador omite tanto a definição de `trace_startup` como a sua chamada.
Lições relacionadas
- C++ · Lição 60 · Avançado · Versão: 3