BG_TEXTO · TEXTO
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:104.
Macro de objeto que expande para const 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: TEXTO. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_TEXTO const char *
Corpo da macro:
const 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
10 ocorrência(s) em 7 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/04_estruturas/e02_tamanho_vetor/programa.c
Contexto: e02_tamanho_vetor. Linhas: 7. Tipo de evidência: código; via TEXTO.
Linhas 5–9 · abrir contexto
VETOR(INTEIRO, a, 7);
VETOR(REAL, b, 3);
VETOR(TEXTO, c, 2);
ESCREVAL(TAMANHO_VETOR(a));
tests/casos/04_estruturas/e05_registro_aninhado/programa.c
Contexto: e05_registro_aninhado. Linhas: 5, 10. Tipo de evidência: código; via TEXTO.
Linhas 3–12 · abrir contexto
REGISTRO(Endereco)
TEXTO rua;
INTEIRO numero;
FIM_REGISTRO(Endereco);
REGISTRO(Pessoa)
TEXTO nome;
Endereco onde;
FIM_REGISTRO(Pessoa);
tests/casos/04_estruturas/e06_vetor_registros/programa.c
Contexto: e06_vetor_registros. Linhas: 5. Tipo de evidência: código; via TEXTO.
Linhas 3–7 · abrir contexto
REGISTRO(Aluno)
TEXTO nome;
REAL nota;
FIM_REGISTRO(Aluno);
tests/casos/04_estruturas/e07_enumeracao/programa.c
Contexto: e07_enumeracao. Linhas: 10. Tipo de evidência: código; via TEXTO.
Linhas 8–12 · abrir contexto
FIM_ENUMERACAO(Cor);
FUNCAO TEXTO nome_da(Cor c) {
ESCOLHA (c)
CASO VERMELHO:
tests/casos/06_negativos/n05_texto_e_imutavel/programa.c
Contexto: n05_texto_e_imutavel. Linhas: 5. Tipo de evidência: código; via TEXTO.
Linhas 3–7 · abrir contexto
// TEXTO aponta para memoria estatica: nao da para escrever nela
INICIO
TEXTO s = "abc";
s[0] = 'x';
ESCREVAL(s);
tests/casos/06_negativos/n21_leia_texto/programa.c
Contexto: n21_leia_texto. Linhas: 13. Tipo de evidência: código; via TEXTO.
Linhas 11–15 · abrir contexto
INICIO
TEXTO nome = "?";
LEIA(nome);
tests/casos/08_aplicacao/app_acervo/acervo.c
Contexto: app_acervo. Linhas: 124, 143, 148. Tipo de evidência: código; via TEXTO.
Linhas 122–126 · abrir contexto
}
FUNCAO TEXTO nome_situacao(Situacao s) {
ESCOLHA (s)
CASO DISPONIVEL:
Linhas 141–150 · abrir contexto
}
FUNCAO TEXTO acervo_titulo(INTEIRO i) {
AFIRME(i >= 0 E i < total, "indice fora do acervo");
RETORNE acervo[i].titulo;
}
FUNCAO TEXTO acervo_autor(INTEIRO i) {
AFIRME(i >= 0 E i < total, "indice fora do acervo");
RETORNE acervo[i].autor;
Também aparece na tabela de expansão conferida por cc -E -dM: L40.
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.
TEXTO→ tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e05_registro_aninhado/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/04_estruturas/e07_enumeracao/programa.c, tests/casos/06_negativos/n05_texto_e_imutavel/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
TEXTOe a forma canônicaBG_TEXTOsã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_TEXTO. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_TEXTO faz?
Macro de objeto que expande para const 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_TEXTO expande?
O pré-processador substitui BG_TEXTO pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
const char *
Como BG_TEXTO aparece em código real deste repositório?
Uso extraído de tests/casos/04_estruturas/e02_tamanho_vetor/programa.c:5, com as linhas vizinhas preservadas:
VETOR(INTEIRO, a, 7);
VETOR(REAL, b, 3);
VETOR(TEXTO, c, 2);
ESCREVAL(TAMANHO_VETOR(a));
Onde BG_TEXTO é exercitado nos testes?
Há 10 ocorrência(s) em 7 arquivo(s): tests/casos/04_estruturas/e02_tamanho_vetor/programa.c, tests/casos/04_estruturas/e05_registro_aninhado/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/04_estruturas/e07_enumeracao/programa.c, tests/casos/06_negativos/n05_texto_e_imutavel/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_TEXTO depende de compilador, padrão C ou sistema operacional?
BG_TEXTO 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.