BG_CARACTERE · CARACTERE
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));
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";
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
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));
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';
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
Linhas 32–35 · abrir contexto
// CARACTERE ocupa exatamente 1 byte; o sinal é o da plataforma (PT-4)
ESCREVAL(sizeof(CARACTERE) == 1);
FIM
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
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");
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")),
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.
CARACTERE→ 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 …
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
defined(BASICGOL_H)(fonte)
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
CARACTEREe a forma canônicaBG_CARACTEREsão a mesma macro; escolha uma por arquivo para não misturar estilos. - Rode
make test(oumake test-bibliotecapara 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.