Pular para o conteúdo principal

BG_ESCREVA_TEXTO · ESCREVA_TEXTO

Página gerada do fonte

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);

Ver no GitHub

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);

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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));

Ver no GitHub

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)

Ver no GitHub

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));

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)

  • Em stdout no Windows, o CRT pode traduzir LF para CRLF no modo texto; os runners normalizam CR nas comparações.

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 ESCREVA_TEXTO e a forma canônica BG_ESCREVA_TEXTO 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_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.