Pular para o conteúdo principal

BG_CARACTERE · CARACTERE

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:86.

Macro de objeto que expande para char. Alias de tipo C: não cria um novo sistema de tipos. Largura, alinhamento, sinal e promoções são os do compilador/alvo; consulte limites.h/float.h por meio das macros de faixa.

Tipo: macro de objeto · Módulo/categoria: Tipos e limites.

Nomes equivalentes: CARACTERE. Os testes de qualquer um desses nomes são reunidos nesta página.

Assinatura e expansão​

#define BG_CARACTERE char

Corpo da macro:

char

Como funciona​

Alias de tipo C: não cria um novo sistema de tipos. Largura, alinhamento, sinal e promoções são os do compilador/alvo; consulte limites.h/float.h por meio das macros de faixa.

Como este símbolo aparece nos testes​

11 ocorrência(s) em 8 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.

tests/casos/02_basico/b04_tipos/programa.c​

Contexto: b04_tipos. Linhas: 17. Tipo de evidência: código; via CARACTERE.

Linhas 15–19 · abrir contexto
ESCREVAL(sizeof(INTEIRO32) == 4);
ESCREVAL(sizeof(INTEIRO64) == 8);
ESCREVAL(sizeof(CARACTERE) == 1);
ESCREVAL(sizeof(INTEIRO) >= 2);
ESCREVAL(sizeof(REAL) >= sizeof(REAL_CURTO));

Ver no GitHub

tests/casos/02_basico/b05_caractere/programa.c​

Contexto: b05_caractere. Linhas: 6. Tipo de evidência: código; via CARACTERE.

Linhas 4–8 · abrir contexto

INICIO
CARACTERE letra = 'B';
CARACTERE quebra = '\n';
TEXTO nome = "BASICGOL";

Ver no GitHub

tests/casos/06_negativos/n12_texto_para_caractere/programa.c​

Contexto: n12_texto_para_caractere. Linhas: 5. Tipo de evidência: código; via CARACTERE.

Linhas 3–7 · abrir contexto

INICIO
CARACTERE c = "A";
ESCREVAL(c);
FIM

Ver no GitHub

tests/casos/09_tipos_expr/t01_inteiros/programa.c​

Contexto: t01_inteiros. Linhas: 19. Tipo de evidência: código; via CARACTERE.

Linhas 17–21 · abrir contexto
ESCREVAL(BITS_DE(INTEIRO32) == 32);
ESCREVAL(BITS_DE(INTEIRO64) == 64);
ESCREVAL(TAMANHO_DE(CARACTERE) == 1);
ESCREVAL(sizeof(INTEIRO_CURTO) <= sizeof(INTEIRO));
ESCREVAL(sizeof(INTEIRO) <= sizeof(INTEIRO_LONGO));

Ver no GitHub

tests/casos/09_tipos_expr/t03_caractere/programa.c​

Contexto: t03_caractere. Linhas: 5, 12, 34. Tipo de evidência: código; via CARACTERE.

Linhas 3–7 · abrir contexto

INICIO
CARACTERE a = 'A';
CARACTERE z = 'Z';

Ver no GitHub

Linhas 10–14 · abrir contexto
ESCREVAL(a + 1); // promoção: 66, e não o caractere 'B'
ESCREVA(a + 2); ESCREVA_LINHA(); // 67 -> 'C'
ESCREVAL((CARACTERE) (a + 1) == 'B');
ESCREVAL(z - a); // distância na tabela: 25

Ver no GitHub

Linhas 32–35 · abrir contexto

// CARACTERE ocupa exatamente 1 byte; o sinal é o da plataforma (PT-4)
ESCREVAL(sizeof(CARACTERE) == 1);
FIM

Ver no GitHub

tests/casos/09_tipos_expr/t06_conversoes/programa.c​

Contexto: t06_conversoes. Linhas: 6, 8. Tipo de evidência: código; via CARACTERE.

Linhas 4–10 · abrir contexto
INICIO
// promoções e casts explícitos
CARACTERE c = 'A';
ESCREVAL(c + 1); // 66 (promoção para INTEIRO)
ESCREVAL((CARACTERE) (c + 1)); // B
INTEIRO i = 7;
ESCREVAL(i / 2); // 3 divisão inteira

Ver no GitHub

tests/casos/09_tipos_expr/t14_propriedades/programa.c​

Contexto: t14_propriedades. Linhas: 21. Tipo de evidência: código; via CARACTERE.

Linhas 19–23 · abrir contexto
_Static_assert(sizeof(INTEIRO32) == 4 && sizeof(INTEIRO64) == 8, "largura exata");
_Static_assert(sizeof(NATURAL8) == 1 && sizeof(NATURAL64) == 8, "largura exata");
_Static_assert(sizeof(CARACTERE) == 1, "CARACTERE ocupa 1 byte");
_Static_assert(sizeof(LOGICO) >= 1, "LOGICO ocupa ao menos 1 byte");
_Static_assert(BITS_DE(INTEIRO16) == 16, "BITS_DE");

Ver no GitHub

tests/portabilidade/precedencia.c​

Contexto: precedencia.c. Linhas: 68. Tipo de evidência: código; via CARACTERE.

Linhas 66–70 · abrir contexto
AFIRME(ARREDONDA(-2.5) == -3, "ARREDONDA(-2.5) afasta do zero");
AFIRME(TAMANHO_VETOR(v) * 2 == 6, "TAMANHO_VETOR em expressão");
AFIRME(BITS_DE(CARACTERE) == 8, "BITS_DE(CARACTERE)");
AFIRME(TAMANHO_DE(INTEIRO8) == 1, "TAMANHO_DE(INTEIRO8)");
AFIRME(TEXTOS_IGUAIS("ab", "ab") E (NAO TEXTOS_DIFERENTES("ab", "ab")),

Ver no GitHub

Evidência indireta​

Estes símbolos chamam/encaminham para este nome. As referências deles ajudam a rastrear o caminho, mas não substituem um teste específico deste símbolo.

Compiladores, padrão C e sistema operacional​

Condições que envolvem a definição:

  • defined(BASICGOL_H) (fonte)
Não confunda implementação com certificação

A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.

Checklist de integração​

  • Compile com C11: o cabeçalho seleciona formatos e divisões com _Generic, e C99/C89 são recusados com mensagem explícita.
  • A forma curta CARACTERE e a forma canônica BG_CARACTERE são a mesma macro; escolha uma por arquivo para não misturar estilos.
  • Rode make test (ou make test-biblioteca para a biblioteca) antes de integrar.
make
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa

Perguntas frequentes​

Perguntas reunidas a partir da definição, do contrato editorial e dos testes de BG_CARACTERE. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que BG_CARACTERE faz?​

Macro de objeto que expande para char. Alias de tipo C: não cria um novo sistema de tipos. Largura, alinhamento, sinal e promoções são os do compilador/alvo; consulte limites.h/float.h por meio das macros de faixa.

Para que exatamente BG_CARACTERE expande?​

O pré-processador substitui BG_CARACTERE pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.

char

Como BG_CARACTERE aparece em código real deste repositório?​

Uso extraído de tests/casos/02_basico/b04_tipos/programa.c:15, com as linhas vizinhas preservadas:

ESCREVAL(sizeof(INTEIRO32) == 4);
ESCREVAL(sizeof(INTEIRO64) == 8);
ESCREVAL(sizeof(CARACTERE) == 1);
ESCREVAL(sizeof(INTEIRO) >= 2);
ESCREVAL(sizeof(REAL) >= sizeof(REAL_CURTO));

Onde BG_CARACTERE é exercitado nos testes?​

Há 11 ocorrência(s) em 8 arquivo(s): tests/casos/02_basico/b04_tipos/programa.c, tests/casos/02_basico/b05_caractere/programa.c, tests/casos/06_negativos/n12_texto_para_caractere/programa.c, tests/casos/09_tipos_expr/t01_inteiros/programa.c, tests/casos/09_tipos_expr/t03_caractere/programa.c …. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.

BG_CARACTERE depende de compilador, padrão C ou sistema operacional?​

BG_CARACTERE exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.

O que acontece em caso de falha ou uso inválido?​

Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.