Pular para o conteúdo principal

BG_ESCREVA_LINHA · ESCREVA_LINHA

Página gerada do fonte

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

Linhas 15–18 · abrir contexto
ESCREVA(" ");
FIM_PARA
ESCREVA_LINHA();
FIM

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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",

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_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

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/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

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)
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_LINHA e a forma canônica BG_ESCREVA_LINHA 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_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.