BG_ESCREVA_LINHA · ESCREVA_LINHA
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:283.
Emite somente um newline em stdout.
Tipo: macro de objeto · Módulo/categoria: Entrada e saída.
Nomes equivalentes: ESCREVA_LINHA. Os testes de qualquer um desses nomes são reunidos nesta página.
Assinatura e expansão
#define BG_ESCREVA_LINHA() fputc('\n', stdout)
Corpo da macro:
fputc('\n', stdout)
Como funciona
Chama fputc('\n', stdout).
Como este símbolo aparece nos testes
36 ocorrência(s) em 17 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: 15. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 13–17 · abrir contexto
ESCREVA("D");
FIM_SE
ESCREVA_LINHA();
}
tests/casos/03_controle/c10_repita_ate_que/programa.c
Contexto: c10_repita_ate_que. Linhas: 10. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 8–12 · abrir contexto
n = n + 1;
ATE_QUE(n >= 3);
ESCREVA_LINHA();
ESCREVAL(n);
FIM
tests/casos/03_controle/c11_para_basico/programa.c
Contexto: c11_para_basico. Linhas: 9. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 7–11 · abrir contexto
ESCREVA(" ");
}
ESCREVA_LINHA();
ESCREVAL(i); // depois do laco vale 6 (foi incrementado)
FIM
tests/casos/03_controle/c13_para_aninhado/programa.c
Contexto: c13_para_aninhado. Linhas: 14. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 12–15 · abrir contexto
}
}
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c14_para_passo/programa.c
Contexto: c14_para_passo. Linhas: 9. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 7–10 · abrir contexto
ESCREVA(" ");
}
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c15_para_acucar/programa.c
Contexto: c15_para_acucar. Linhas: 11. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 9–12 · abrir contexto
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c16_para_acucar_decrescente/programa.c
Contexto: c16_para_acucar_decrescente. Linhas: 11, 17. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 9–13 · abrir contexto
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();
PARA i DE 0 ATE 10 PASSO 5 FACA
Linhas 15–18 · abrir contexto
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c17_repita_ate_acucar/programa.c
Contexto: c17_repita_ate_acucar. Linhas: 12. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 10–13 · abrir contexto
ESCREVA(" ");
ATE n >= 3;
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c19_escolha_fallthrough/programa.c
Contexto: c19_escolha_fallthrough. Linhas: 32. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 30–33 · abrir contexto
ESCREVA("outro ");
FIM_ESCOLHA
ESCREVA_LINHA();
FIM
tests/casos/03_controle/c23_para_passo_negativo/programa.c
Contexto: c23_para_passo_negativo. Linhas: 9, 14. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 7–16 · abrir contexto
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA();
PARA_PASSO (i, 0, 4, 2) {
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA();
// passo negativo que nunca alcança o limite: nenhuma iteração
tests/casos/03_controle/c25_limites_inclusivos/programa.c
Contexto: c25_limites_inclusivos. Linhas: 17, 22, 27, 32, 37. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 15–39 · abrir contexto
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA(); // 1 2 3
PARA_PASSO (i, 1, 10, 4) { // 10 não é alcançado: 1, 5, 9
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA(); // 1 5 9
PARA_PASSO (i, 0, 10, 5) { // o fim cai no passo: 0, 5, 10
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA(); // 0 5 10
PARA_PASSO (i, 10, 0, -5) { // descendo, o fim também é incluído
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA(); // 10 5 0
PARA (i, -2, 1) { // faixa que cruza zero
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA(); // -2 -1 0 1
ESCREVAL(n); // 1
tests/casos/03_controle/c40_passo_sem_sinal/programa.c
Contexto: c40_passo_sem_sinal. Linhas: 11. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 9–13 · abrir contexto
ESCREVA_FMT("%d ", i);
}
ESCREVA_LINHA();
PARA_PASSO (i, 6, 0, passo) { // passo positivo sem alcançar o fim: vazio
ESCREVAL("nunca");
tests/casos/05_entrada_saida/i02_escreval_linha_texto/programa.c
Contexto: i02_escreval_linha_texto. Linhas: 7, 11. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 5–12 · abrir contexto
ESCREVA("a");
ESCREVA("b");
ESCREVA_LINHA();
ESCREVAL("c");
ESCREVA_TEXTO("d");
ESCREVA_TEXTO("e");
ESCREVA_LINHA();
FIM
tests/casos/05_entrada_saida/i12_erro_fatal/programa.c
Contexto: i12_erro_fatal. Linhas: 6. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 4–8 · abrir contexto
INICIO
ESCREVA("antes");
ESCREVA_LINHA();
ERRO("divisao por zero");
ESCREVAL("nunca");
tests/casos/08_aplicacao/app_acervo/principal.c
Contexto: app_acervo. Linhas: 114. Tipo de evidência: código; via ESCREVA_LINHA.
Linhas 112–116 · abrir contexto
ESCREVA_FMT(" %d", acervo_id(k));
}
ESCREVA_LINHA();
ESCREVA_FMT("fim: %d livro(s), %d emprestado(s), %d recusa(s)\n",
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_LINHA.
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
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)
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_LINHA.
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_LINHA→ 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 …
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
ESCREVA_LINHAe a forma canônicaBG_ESCREVA_LINHAsã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_LINHA. 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_LINHA faz?
Emite somente um newline em stdout.
Para que exatamente BG_ESCREVA_LINHA expande?
O pré-processador substitui BG_ESCREVA_LINHA pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
fputc('\n', stdout)
Como BG_ESCREVA_LINHA aparece em código real deste repositório?
Uso extraído de tests/casos/03_controle/c03_senao_se/programa.c:13, com as linhas vizinhas preservadas:
ESCREVA("D");
FIM_SE
ESCREVA_LINHA();
}
Onde BG_ESCREVA_LINHA é exercitado nos testes?
Há 36 ocorrência(s) em 17 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_LINHA depende de compilador, padrão C ou sistema operacional?
BG_ESCREVA_LINHA 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.