Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

Macros de C para a versão da linguagem e disponibilidade de funcionalidades

Distinga a versão da linguagem, o ambiente de execução, as funcionalidades opcionais em falta e as revisões dos cabeçalhos. Estas macros permitem selecionar código durante a compilação, mas não atestam que o ambiente de execução de produção funciona.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202311L
/* C23 or later */
#endif

#ifndef __STDC_NO_ATOMICS__
/* Atomic support is not declared absent. */
#endif

#include <limits.h>
#if defined(__STDC_VERSION_LIMITS_H__) && __STDC_VERSION_LIMITS_H__ >= 202311L
/* C23 header revision or later */
#endif

__STDC__ tem o valor 1 numa implementação conforme com a norma; __STDC_VERSION__ tem o valor 202311L para C23. __STDC_HOSTED__ tem o valor 1 em ambientes hosted e 0 em ambientes freestanding.

As macros com o valor 1 indicam suporte em falta: __STDC_NO_ATOMICS__ — tipos atómicos e <stdatomic.h>; __STDC_NO_COMPLEX__ — tipos complexos e <complex.h>; __STDC_NO_THREADS__ — <threads.h>. Em C23, __STDC_NO_VLA__ diz respeito apenas a VLA com duração de armazenamento automática, não a todos os tipos de dimensão variável; as declarações de parâmetros VLA continuam a ser obrigatórias.

Depois de incluir os cabeçalhos correspondentes, verifique as respetivas revisões: __STDC_VERSION_STDIO_H__ → <stdio.h>, __STDC_VERSION_STDLIB_H__ → <stdlib.h>, __STDC_VERSION_LIMITS_H__ → <limits.h>, __STDC_VERSION_STDINT_H__ → <stdint.h>, __STDC_VERSION_STDBIT_H__ → <stdbit.h>, __STDC_VERSION_STDCKDINT_H__ → <stdckdint.h>. Em C23, todos têm o valor 202311L.

Use defined e comparações >=, não a igualdade de versões. Não defina estes nomes por iniciativa própria. Uma opção C23 no repositório não atesta a conformidade da biblioteca nem o ambiente de execução de produção.

Exemplos

#include <limits.h>
#include <stdio.h>

int main(void)
{
    printf("c23=%d\n", __STDC_VERSION__ >= 202311L);
#ifdef __STDC_VERSION_LIMITS_H__
    printf("limits_revision=%ld\n", (long)__STDC_VERSION_LIMITS_H__);
#else
    puts("limits_revision=not-reported");
#endif
    return 0;
}

Resultado

c23=1
limits_revision=not-reported

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes