Pular para o conteúdo principal

BG_TEXTO_FIXO · TEXTO_FIXO

Página gerada do fonte

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

Declara buffer mutável de texto com capacidade em bytes.

Tipo: macro com argumentos · Módulo/categoria: Programa e declarações.

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

Assinatura e expansão​

#define BG_TEXTO_FIXO(n, k) char n[k]

Parâmetros formais: n, k.

Corpo da macro:

char n[k]

Como funciona​

Expande para char n[k]; a capacidade inclui o terminador NUL quando usado pelas rotinas de texto.

Como este símbolo aparece nos testes​

22 ocorrência(s) em 13 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/e03_texto_buffer/programa.c​

Contexto: e03_texto_buffer. Linhas: 5, 6. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 3–8 · abrir contexto

INICIO
TEXTO_FIXO(nome, 16);
TEXTO_FIXO(saudacao, 32);

COPIA_TEXTO(nome, (INTEIRO) sizeof nome, "mundo");

Ver no GitHub

tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c​

Contexto: i06_leia_texto_apos_leia. Linhas: 7. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 5–9 · abrir contexto
INICIO
INTEIRO idade = 0;
TEXTO_FIXO(nome, 32);

SE LEIA_OK(idade) ENTAO

Ver no GitHub

tests/casos/05_entrada_saida/i07_leia_texto_limpo/programa.c​

Contexto: i07_leia_texto_limpo. Linhas: 6. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 4–8 · abrir contexto

INICIO
TEXTO_FIXO(linha, 32);
SE LEIA_TEXTO(linha, (INTEIRO) sizeof linha) ENTAO
ESCREVA("[");

Ver no GitHub

tests/casos/05_entrada_saida/i08_leia_texto_truncamento/programa.c​

Contexto: i08_leia_texto_truncamento. Linhas: 6, 7. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 4–9 · abrir contexto

INICIO
TEXTO_FIXO(pequeno, 5);
TEXTO_FIXO(depois, 16);

SE LEIA_TEXTO(pequeno, (INTEIRO) sizeof pequeno) ENTAO

Ver no GitHub

tests/casos/05_entrada_saida/i09_texto_truncamento/programa.c​

Contexto: i09_texto_truncamento. Linhas: 6, 7. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 4–9 · abrir contexto

INICIO
TEXTO_FIXO(a, 4);
TEXTO_FIXO(b, 8);
LOGICO ok = FALSO;

Ver no GitHub

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

Contexto: n22_leia_texto_fixo. Linhas: 13. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 11–15 · abrir contexto

INICIO
TEXTO_FIXO(buf, 8);

LEIA(buf);

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/acervo.h​

Contexto: app_acervo. Linhas: 26, 27. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 24–29 · abrir contexto
REGISTRO(Livro)
INTEIRO id;
TEXTO_FIXO(titulo, TITULO_MAX);
TEXTO_FIXO(autor, AUTOR_MAX);
INTEIRO ano;
Situacao situacao;

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/principal.c​

Contexto: app_acervo. Linhas: 32, 57. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 30–34 · abrir contexto

INICIO
TEXTO_FIXO(linha, 64);
INTEIRO quota = 0;
REAL fator = 1.0;

Ver no GitHub

Linhas 55–59 · abrir contexto
quota, fator, ACERVO_MAX);

TEXTO_FIXO(comando, 64);
LOGICO sair = FALSO;
INTEIRO recusados = 0;

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/relatorio.c​

Contexto: app_acervo. Linhas: 36, 37, 44. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 34–39 · abrir contexto

// dois JUNTA_TEXTO encadeados: "titulo - autor"
TEXTO_FIXO(parcial, 64);
TEXTO_FIXO(rotulo, 64);
SE JUNTA_TEXTO(parcial, 64, acervo_titulo(0), " - ") E
JUNTA_TEXTO(rotulo, 64, parcial, acervo_autor(0)) ENTAO

Ver no GitHub

Linhas 42–46 · abrir contexto
FIM_SE

TEXTO_FIXO(situacao_txt, 16);
COPIA_TEXTO(situacao_txt, 16, nome_situacao(acervo_situacao(0)));
SE TEXTOS_IGUAIS(situacao_txt, "disponivel") ENTAO

Ver no GitHub

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

Contexto: t11_texto_seguro. Linhas: 5, 6. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 3–8 · abrir contexto

INICIO
TEXTO_FIXO(buf, 8);
TEXTO_FIXO(dest, 4);

// --- cópia: 7 caracteres + NUL cabem em 8; 8 não cabem

Ver no GitHub

tests/portabilidade/entrada.c​

Contexto: entrada.c. Linhas: 17, 18. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 15–20 · abrir contexto
REAL r = -1.0;
CARACTERE c = '?';
TEXTO_FIXO(linha, 32);
TEXTO_FIXO(curto, 4);
LOGICO ok;

Ver no GitHub

tests/run_portabilidade.sh​

Contexto: run_portabilidade.sh. Linhas: 184. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 182–186 · abrir contexto
cat > "$TMP/h.c" <<'EOF'
#include <basicgol.h>

/* uso real: uma macro de cada família, para o compilador analisar de verdade */
INICIO

Ver no GitHub

tests/run_portabilidade.sh · heredoc na linha 183​

Contexto: C incorporado no runner (linha 183). Linhas: 189. Tipo de evidência: código; via TEXTO_FIXO.

Linhas 187–191 · abrir contexto
INTEIRO i = 0;
LOGICO b = VERDADEIRO;
TEXTO_FIXO(buf, 16);

SE b E (i < 1) ENTAO

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 TEXTO_FIXO e a forma canônica BG_TEXTO_FIXO 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_TEXTO_FIXO. 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_FIXO faz?​

Declara buffer mutável de texto com capacidade em bytes.

Para que exatamente BG_TEXTO_FIXO expande?​

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

Parâmetros formais: n, k.

char n[k]

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

Uso extraído de tests/casos/04_estruturas/e03_texto_buffer/programa.c:3, com as linhas vizinhas preservadas:


INICIO
TEXTO_FIXO(nome, 16);
TEXTO_FIXO(saudacao, 32);

Onde BG_TEXTO_FIXO é exercitado nos testes?​

Há 22 ocorrência(s) em 13 arquivo(s): tests/casos/04_estruturas/e03_texto_buffer/programa.c, tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c, tests/casos/05_entrada_saida/i07_leia_texto_limpo/programa.c, tests/casos/05_entrada_saida/i08_leia_texto_truncamento/programa.c, tests/casos/05_entrada_saida/i09_texto_truncamento/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_FIXO depende de compilador, padrão C ou sistema operacional?​

BG_TEXTO_FIXO 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.