BG_ESCREVA_TEXTO · ESCREVA_TEXTO
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:284.
BG_ESCREVA_TEXTO: interface macro da biblioteca. Escreve texto literal em um FILE, sem interpretar formatos printf.
Tipo: macro com argumentos · Módulo/categoria: Entrada e saída.
Nomes equivalentes: ESCREVA_TEXTO. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_ESCREVA_TEXTO(s) bg_escreva_texto(stdout, (s))
Parâmetros formais: s.
Corpo da macro:
bg_escreva_texto(stdout, (s))
Como funciona
Valida fluxo e texto e usa fputs. Assim, %s e %n dentro do texto continuam caracteres literais.
Retorno: true se fputs não indicar erro; false para NULL ou falha de escrita.
Exemplo de uso
ESCREVA_TEXTO("100% literal\n");
Nomes internos referenciados: bg_escreva_texto.
Como este símbolo aparece nos testes
18 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/e05_registro_aninhado/programa.c
Contexto: e05_registro_aninhado. Linhas: 20, 22. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 18–24 · abrir contexto
p.onde.numero = 42;
ESCREVA_TEXTO(p.nome);
ESCREVA(" mora em ");
ESCREVA_TEXTO(p.onde.rua);
ESCREVA(", ");
ESCREVAL(p.onde.numero);
tests/casos/04_estruturas/e06_vetor_registros/programa.c
Contexto: e06_vetor_registros. Linhas: 19. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 17–21 · abrir contexto
PARA (i, 0, 2) {
ESCREVA_TEXTO(turma[i].nome);
ESCREVA(": ");
ESCREVA_FMT("%.1f\n", turma[i].nota);
tests/casos/05_entrada_saida/i02_escreval_linha_texto/programa.c
Contexto: i02_escreval_linha_texto. Linhas: 9, 10. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 7–12 · abrir contexto
ESCREVA_LINHA();
ESCREVAL("c");
ESCREVA_TEXTO("d");
ESCREVA_TEXTO("e");
ESCREVA_LINHA();
FIM
tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c
Contexto: i06_leia_texto_apos_leia. Linhas: 15. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 13–17 · abrir contexto
SE LEIA_TEXTO(nome, (INTEIRO) sizeof nome) ENTAO
ESCREVA("nome [");
ESCREVA_TEXTO(nome);
ESCREVAL("]");
FIM_SE
tests/casos/05_entrada_saida/i07_leia_texto_limpo/programa.c
Contexto: i07_leia_texto_limpo. Linhas: 9. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 7–11 · abrir contexto
SE LEIA_TEXTO(linha, (INTEIRO) sizeof linha) ENTAO
ESCREVA("[");
ESCREVA_TEXTO(linha);
ESCREVAL("]");
FIM_SE
tests/casos/05_entrada_saida/i08_leia_texto_truncamento/programa.c
Contexto: i08_leia_texto_truncamento. Linhas: 17. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 15–19 · abrir contexto
SE LEIA_TEXTO(depois, (INTEIRO) sizeof depois) ENTAO
ESCREVA("proxima [");
ESCREVA_TEXTO(depois);
ESCREVAL("]");
FIM_SE
tests/casos/09_tipos_expr/t11_texto_seguro/programa.c
Contexto: t11_texto_seguro. Linhas: 10, 12, 18, 25, 31, 33, 40, 45, 63, 65. Tipo de evidência: código; via ESCREVA_TEXTO.
Linhas 8–14 · abrir contexto
// --- cópia: 7 caracteres + NUL cabem em 8; 8 não cabem
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "abc"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "1234567"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "12345678"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0: falha limpa o destino
Linhas 16–20 · abrir contexto
// --- junção de dois textos
ESCREVAL(JUNTA_TEXTO(buf, TAMANHO_VETOR(buf), "ab", "cd"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(JUNTA_TEXTO(buf, TAMANHO_VETOR(buf), "abcd", "efgh"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0
Linhas 23–27 · abrir contexto
ESCREVAL(COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "ab"));
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), "cd"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), "efgh"));
ESCREVAL(TAMANHO_TEXTO(buf)); // 0: 6 caracteres não caberiam
Linhas 29–35 · abrir contexto
// --- trecho: quantidade limitada ao que existe, início além do fim = vazio
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 2, 3));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 4, 99));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef", 99, 1));
ESCREVAL(TAMANHO_TEXTO(buf));
Linhas 38–47 · abrir contexto
// --- formatação verificável (sem inspeção de formato pelo compilador)
ESCREVAL(FORMATA_TEXTO(buf, TAMANHO_VETOR(buf), "%d-%s", 42, "xy"));
ESCREVA_TEXTO(buf); ESCREVA_LINHA();
ESCREVAL(FORMATA_TEXTO(dest, TAMANHO_VETOR(dest), "%s", "longo"));
ESCREVAL(TAMANHO_TEXTO(dest));
TEXTO formato = "<%d>";
ESCREVAL(FORMATA_TEXTO(dest, TAMANHO_VETOR(dest), formato, 7));
ESCREVA_TEXTO(dest); ESCREVA_LINHA();
// --- comparação normalizada e texto vazio (NULL conta como vazio)
Linhas 61–67 · abrir contexto
COPIA_TEXTO(buf, TAMANHO_VETOR(buf), "abcdef");
ESCREVAL(TRECHO_TEXTO(buf, TAMANHO_VETOR(buf), buf, 2, 3));
ESCREVA_TEXTO(buf); ESCREVA_LINHA(); // cde
ESCREVAL(ACRESCENTA_TEXTO(buf, TAMANHO_VETOR(buf), buf)); // "cde"+"cde"
ESCREVA_TEXTO(buf); ESCREVA_LINHA(); // cdecde
ESCREVAL(ACRESCENTA_TEXTO(buf, 6, buf)); // nao cabe em 6: falha
ESCREVAL(TAMANHO_TEXTO(buf));
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.
ESCREVA_TEXTO→ tests/casos/04_estruturas/e05_registro_aninhado/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/05_entrada_saida/i02_escreval_linha_texto/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 …
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
-
defined(BASICGOL_H)(fonte) -
Em stdout no Windows, o CRT pode traduzir LF para CRLF no modo texto; os runners normalizam CR nas comparações.
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
ESCREVA_TEXTOe a forma canônicaBG_ESCREVA_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_ESCREVA_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_ESCREVA_TEXTO faz?
BG_ESCREVA_TEXTO: interface macro da biblioteca. Escreve texto literal em um FILE, sem interpretar formatos printf.
Para que exatamente BG_ESCREVA_TEXTO expande?
O pré-processador substitui BG_ESCREVA_TEXTO pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: s.
bg_escreva_texto(stdout, (s))
Como usar BG_ESCREVA_TEXTO em um programa?
Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:
ESCREVA_TEXTO("100% literal\n");
Onde BG_ESCREVA_TEXTO é exercitado nos testes?
Há 18 ocorrência(s) em 7 arquivo(s): tests/casos/04_estruturas/e05_registro_aninhado/programa.c, tests/casos/04_estruturas/e06_vetor_registros/programa.c, tests/casos/05_entrada_saida/i02_escreval_linha_texto/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 …. 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_ESCREVA_TEXTO depende de compilador, padrão C ou sistema operacional?
BG_ESCREVA_TEXTO exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Ressalvas registradas: Em stdout no Windows, o CRT pode traduzir LF para CRLF no modo texto; os runners normalizam CR nas comparações.
O que acontece em caso de falha ou uso inválido?
true se fputs não indicar erro; false para NULL ou falha de escrita.