Pular para o conteúdo principal

BG_ESCREVA · ESCREVA

Página gerada do fonte

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

Imprime um valor escalar ou texto sem acrescentar newline.

Tipo: macro com argumentos · Módulo/categoria: Entrada e saída.

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

Assinatura e expansão​

#define BG_ESCREVA(x) printf(BG_FMT(x), (x))

Parâmetros formais: x.

Corpo da macro:

printf(BG_FMT(x), (x))

Como funciona​

Chama printf(BG_FMT(x), x). A seleção de formato é estática.

Contrato e armadilhas
  • Uma chamada recebe um valor; para múltiplos use ESCREVA_FMT.
  • NULL em %s não é portable entre CRTs; valide antes de imprimir.

Nomes internos referenciados: BG_FMT.

Como este símbolo aparece nos testes​

69 ocorrência(s) em 30 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/03_controle/c03_senao_se/programa.c​

Contexto: c03_senao_se. Linhas: 7, 9, 11, 13. Tipo de evidência: código; via ESCREVA.

Linhas 5–15 · abrir contexto
PROCEDIMENTO classifica(INTEIRO nota) {
SE nota >= 90 ENTAO
ESCREVA("A");
SENAO_SE nota >= 70 ENTAO
ESCREVA("B");
SENAO_SE nota >= 50 ENTAO
ESCREVA("C");
SENAO
ESCREVA("D");
FIM_SE
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c10_repita_ate_que/programa.c​

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

Linhas 4–9 · abrir contexto
INTEIRO n = 0;
REPITA
ESCREVA(n);
ESCREVA(" ");
n = n + 1;
ATE_QUE(n >= 3);

Ver no GitHub

tests/casos/03_controle/c11_para_basico/programa.c​

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

Linhas 4–9 · abrir contexto
INTEIRO i = 0;
PARA (i, 1, 5) {
ESCREVA(i);
ESCREVA(" ");
}
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c13_para_aninhado/programa.c​

Contexto: c13_para_aninhado. Linhas: 8, 9, 10, 11. Tipo de evidência: código; via ESCREVA.

Linhas 6–13 · abrir contexto
PARA (i, 1, 3) {
PARA (j, 1, 2) {
ESCREVA(i);
ESCREVA("x");
ESCREVA(j);
ESCREVA(" ");
}
}

Ver no GitHub

tests/casos/03_controle/c14_para_passo/programa.c​

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

Linhas 4–9 · abrir contexto
INTEIRO i = 0;
PARA_PASSO (i, 0, 100, 25) {
ESCREVA(i);
ESCREVA(" ");
}
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c15_para_acucar/programa.c​

Contexto: c15_para_acucar. Linhas: 8, 9. Tipo de evidência: código; via ESCREVA.

Linhas 6–11 · abrir contexto
INTEIRO i = 0;
PARA i DE 1 ATE 3 FACA
ESCREVA(i);
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c16_para_acucar_decrescente/programa.c​

Contexto: c16_para_acucar_decrescente. Linhas: 8, 9, 14, 15. Tipo de evidência: código; via ESCREVA.

Linhas 6–17 · abrir contexto
INTEIRO i = 0;
PARA i DE 3 ATE 1 PASSO -1 FACA
ESCREVA(i);
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();

PARA i DE 0 ATE 10 PASSO 5 FACA
ESCREVA(i);
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c17_repita_ate_acucar/programa.c​

Contexto: c17_repita_ate_acucar. Linhas: 9, 10. Tipo de evidência: código; via ESCREVA.

Linhas 7–12 · abrir contexto
REPITA
n = n + 1;
ESCREVA(n);
ESCREVA(" ");
ATE n >= 3;
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c19_escolha_fallthrough/programa.c​

Contexto: c19_escolha_fallthrough. Linhas: 21, 24, 27, 30. Tipo de evidência: código; via ESCREVA.

Linhas 19–32 · abrir contexto
ESCOLHA (2)
CASO 1:
ESCREVA("um ");
cai_para_proximo;
CASO 2:
ESCREVA("dois ");
cai_para_proximo;
CASO 3:
ESCREVA("tres ");
PARE;
CONTRARIO:
ESCREVA("outro ");
FIM_ESCOLHA
ESCREVA_LINHA();

Ver no GitHub

tests/casos/03_controle/c36_laco_entrada_sentinela/programa.c​

Contexto: c36_laco_entrada_sentinela. Linhas: 34, 36, 38, 40, 54. Tipo de evidência: código; via ESCREVA.

Linhas 32–42 · abrir contexto
FIM_SE
FIM_ENQUANTO
ESCREVA("quantidade: ");
ESCREVAL(qtd);
ESCREVA("soma: ");
ESCREVAL(soma);
ESCREVA("maximo: ");
ESCREVAL(maximo);
ESCREVA("minimo: ");
ESCREVAL(minimo);

Ver no GitHub

Linhas 52–56 · abrir contexto
FIM_SE
FIM_ENQUANTO
ESCREVA("quantidade: ");
ESCREVAL(qtd);
FIM

Ver no GitHub

tests/casos/04_estruturas/e04_registro/programa.c​

Contexto: e04_registro. Linhas: 10, 12. Tipo de evidência: código; via ESCREVA.

Linhas 8–14 · abrir contexto

PROCEDIMENTO imprime(Ponto p) {
ESCREVA("(");
ESCREVA_FMT("%.1f", p.x);
ESCREVA(", ");
ESCREVA_FMT("%.1f", p.y);
ESCREVAL(")");

Ver no GitHub

tests/casos/04_estruturas/e05_registro_aninhado/programa.c​

Contexto: e05_registro_aninhado. Linhas: 21, 23. Tipo de evidência: código; via ESCREVA.

Linhas 19–25 · abrir contexto

ESCREVA_TEXTO(p.nome);
ESCREVA(" mora em ");
ESCREVA_TEXTO(p.onde.rua);
ESCREVA(", ");
ESCREVAL(p.onde.numero);
FIM

Ver no GitHub

tests/casos/04_estruturas/e06_vetor_registros/programa.c​

Contexto: e06_vetor_registros. Linhas: 20. Tipo de evidência: código; via ESCREVA.

Linhas 18–22 · abrir contexto
PARA (i, 0, 2) {
ESCREVA_TEXTO(turma[i].nome);
ESCREVA(": ");
ESCREVA_FMT("%.1f\n", turma[i].nota);
total = total + turma[i].nota;

Ver no GitHub

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

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

Linhas 3–8 · abrir contexto

INICIO
ESCREVA("a");
ESCREVA("b");
ESCREVA_LINHA();
ESCREVAL("c");

Ver no GitHub

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

Contexto: i04_leia_tipos. Linhas: 10, 17. Tipo de evidência: código; via ESCREVA.

Linhas 8–12 · abrir contexto

SE LEIA_OK(n) ENTAO
ESCREVA("int ");
ESCREVAL(n);
FIM_SE

Ver no GitHub

Linhas 15–19 · abrir contexto
FIM_SE
SE LEIA_OK(c) ENTAO
ESCREVA("char ");
ESCREVAL(c);
FIM_SE

Ver no GitHub

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

Contexto: i06_leia_texto_apos_leia. Linhas: 10, 14. Tipo de evidência: código; via ESCREVA.

Linhas 8–16 · abrir contexto

SE LEIA_OK(idade) ENTAO
ESCREVA("idade ");
ESCREVAL(idade);
FIM_SE
SE LEIA_TEXTO(nome, (INTEIRO) sizeof nome) ENTAO
ESCREVA("nome [");
ESCREVA_TEXTO(nome);
ESCREVAL("]");

Ver no GitHub

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

Contexto: i07_leia_texto_limpo. Linhas: 8. Tipo de evidência: código; via ESCREVA.

Linhas 6–10 · abrir contexto
TEXTO_FIXO(linha, 32);
SE LEIA_TEXTO(linha, (INTEIRO) sizeof linha) ENTAO
ESCREVA("[");
ESCREVA_TEXTO(linha);
ESCREVAL("]");

Ver no GitHub

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

Contexto: i08_leia_texto_truncamento. Linhas: 16. Tipo de evidência: código; via ESCREVA.

Linhas 14–18 · abrir contexto

SE LEIA_TEXTO(depois, (INTEIRO) sizeof depois) ENTAO
ESCREVA("proxima [");
ESCREVA_TEXTO(depois);
ESCREVAL("]");

Ver no GitHub

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

Contexto: i12_erro_fatal. Linhas: 5. Tipo de evidência: código; via ESCREVA.

Linhas 3–7 · abrir contexto

INICIO
ESCREVA("antes");
ESCREVA_LINHA();
ERRO("divisao por zero");

Ver no GitHub

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

Contexto: i15_leia_caractere_apos_numero. Linhas: 8, 10. Tipo de evidência: código; via ESCREVA.

Linhas 6–12 · abrir contexto
INTEIRO n = 0;
CARACTERE c = '?';
ESCREVA("numero: ");
SE LEIA_OK(n) ENTAO
ESCREVA("letra: ");
SE LEIA_OK(c) ENTAO
ESCREVA_FMT("lido %d e '%c'\n", n, c);

Ver no GitHub

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

Contexto: app_acervo. Linhas: 109. Tipo de evidência: código; via ESCREVA.

Linhas 107–111 · abrir contexto
ATE_QUE (sair);

ESCREVA("ids em ordem decrescente:");
INTEIRO k = 0;
PARA_PASSO (k, quantidade() - 1, 0, -1) {

Ver no GitHub

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

Contexto: t03_caractere. Linhas: 11, 29, 30, 31. Tipo de evidência: código; via ESCREVA.

Linhas 9–13 · abrir contexto
ESCREVAL(z);
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

Ver no GitHub

Linhas 27–33 · abrir contexto
ESCREVAL(E_LETRA('a'));
ESCREVAL(E_LETRA('_'));
ESCREVA(CARACTERE_MAIUSCULO('q')); ESCREVA_LINHA();
ESCREVA(CARACTERE_MINUSCULO('Q')); ESCREVA_LINHA();
ESCREVA(CARACTERE_MAIUSCULO('1')); ESCREVA_LINHA();

// CARACTERE ocupa exatamente 1 byte; o sinal é o da plataforma (PT-4)

Ver no GitHub

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

Contexto: t10_estouro_divisao. Linhas: 9, 18. Tipo de evidência: código; via ESCREVA.

Linhas 7–11 · abrir contexto

if (MINIMO_INTEIRO < -MAXIMO_INTEIRO) {
ESCREVA("MIN/-1: nao representavel");
quociente = DIVIDE(minimo, -1);
RETORNE 9; /* DIVIDE precisa falhar nesta representação. */

Ver no GitHub

Linhas 16–20 · abrir contexto
RETORNE 9;
}
ESCREVA("MIN/-1: representavel: ");
ESCREVAL("ok");
FIM

Ver no GitHub

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

Contexto: t15_leia_tipos. Linhas: 28, 29, 30, 31, 32, 33. Tipo de evidência: código; via ESCREVA.

Linhas 26–34 · abrir contexto
LEIA(f);

ESCREVA("NATURAL8 "); ESCREVAL(a);
ESCREVA("NATURAL16 "); ESCREVAL(b);
ESCREVA("NATURAL_CURTO "); ESCREVAL(c);
ESCREVA("REAL_CURTO "); ESCREVAL(d);
ESCREVA("REAL_LONGO "); ESCREVAL(e);
ESCREVA("CARACTERE "); ESCREVAL(f);
FIM

Ver no GitHub

tests/run.sh​

Contexto: run.sh. Linhas: 204, 205. Tipo de evidência: código; via ESCREVA.

Linhas 202–207 · abrir contexto
#include <basicgol.h>
#ifdef BG_TEM_EXTENSOES
#error "BG_TEM_EXTENSOES nao deveria existir sem BG_USAR_EXTENSOES"
#endif
#ifdef SOMA_SEGURA
#error "SOMA_SEGURA nao deveria existir sem BG_USAR_EXTENSOES"

Ver no GitHub

tests/run.sh · heredoc na linha 219​

Contexto: C incorporado no runner (linha 219). Linhas: 222, 223. Tipo de evidência: código; via ESCREVA.

Linhas 220–224 · abrir contexto
_Static_assert(BG_VERSAO_MINIMA(1, 0), "exige 1.0");
INICIO
ESCREVA(BG_VERSAO_MAIOR); ESCREVA("."); ESCREVA(BG_VERSAO_MENOR);
ESCREVA("."); ESCREVAL(BG_VERSAO_CORRECAO);
FIM

Ver no GitHub

tests/run.sh · heredoc na linha 235​

Contexto: C incorporado no runner (linha 235). Linhas: 242, 244. Tipo de evidência: código; via ESCREVA.

Linhas 240–245 · abrir contexto
a = ABS(++i); /* uma avaliacao: i=1, a=1 */
b = MINIMO(++i, 100); /* uma avaliacao: i=2, b=2 */
ESCREVA(i); ESCREVA(" "); ESCREVA(a); ESCREVA(" "); ESCREVAL(b);
i = 0;
ESCREVA(i++); ESCREVA(" "); ESCREVAL(i); /* imprime 0 e depois 1 */
FIM

Ver no GitHub

tests/run.sh · heredoc na linha 256​

Contexto: C incorporado no runner (linha 256). Linhas: 263. Tipo de evidência: código; via ESCREVA.

Linhas 261–265 · abrir contexto
q = DIVIDE(++i, 1); /* uma avaliacao: i=1 */
x = OU_EXCLUSIVO(++i, 0); /* uma avaliacao: i=2 */
ESCREVA(i); ESCREVA(" "); ESCREVA(q); ESCREVA(" ");
ESCREVAL(x);
FIM

Ver no GitHub

tests/run_portabilidade.sh​

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

Linhas 188–192 · abrir contexto
LOGICO b = VERDADEIRO;
TEXTO_FIXO(buf, 16);

SE b E (i < 1) ENTAO
ESCREVAL("x");

Ver no GitHub

tests/run_portabilidade.sh · heredoc na linha 183​

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

Linhas 193–197 · abrir contexto
FIM_SE
PARA (i, 0, 1) {
ESCREVA(i);
}
ESCREVAL(ABS(-1) + MINIMO(1, 2) + DIVIDE(4, 2));

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 ESCREVA e a forma canônica BG_ESCREVA 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. 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 faz?​

Imprime um valor escalar ou texto sem acrescentar newline.

Para que exatamente BG_ESCREVA expande?​

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

Parâmetros formais: x.

printf(BG_FMT(x), (x))

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

Uso extraído de tests/casos/03_controle/c03_senao_se/programa.c:5, com as linhas vizinhas preservadas:

PROCEDIMENTO classifica(INTEIRO nota) {
SE nota >= 90 ENTAO
ESCREVA("A");
SENAO_SE nota >= 70 ENTAO
ESCREVA("B");

Onde BG_ESCREVA é exercitado nos testes?​

Há 69 ocorrência(s) em 30 arquivo(s): tests/casos/03_controle/c03_senao_se/programa.c, tests/casos/03_controle/c10_repita_ate_que/programa.c, tests/casos/03_controle/c11_para_basico/programa.c, tests/casos/03_controle/c13_para_aninhado/programa.c, tests/casos/03_controle/c14_para_passo/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 depende de compilador, padrão C ou sistema operacional?​

BG_ESCREVA exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.

Quais armadilhas preciso evitar ao usar BG_ESCREVA?​

O contrato editorial registra: “Uma chamada recebe um valor; para múltiplos use ESCREVA_FMT.” “NULL em %s não é portable entre CRTs; valide antes de imprimir.”