Pular para o conteúdo principal

BG_LEIA_TEXTO · LEIA_TEXTO

Página gerada do fonte

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

BG_LEIA_TEXTO: interface macro da biblioteca. Wrapper de stdin compatível com LEIA_TEXTO, descartando um newline deixado por leitura formatada anterior.

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

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

Assinatura e expansão​

#define BG_LEIA_TEXTO(b, t) bg_leia_texto((b), (size_t) (t))

Parâmetros formais: b, t.

Corpo da macro:

bg_leia_texto((b), (size_t) (t))

Como funciona​

Inspeciona o próximo byte de stdin. Se for LF ou CRLF pendente, consome esse terminador antes de chamar bg_leia_linha. Caso contrário devolve o byte com ungetc e lê a linha atual.

Contrato e armadilhas
  • Uma linha vazia intencional pode ser confundida com o newline pendente; prefira bg_leia_linha(stdin, ...) quando isso importar.
  • Não mistura leitura de texto com scanf depois de começar a usar bg_leia_linha sem entender o estado do fluxo.

Exemplo de uso​

TEXTO_FIXO(nome, 80);
SE LEIA_TEXTO(nome, TAMANHO_DE(nome)) ENTAO
ESCREVAL(nome);
FIM_SE

Nomes internos referenciados: bg_leia_texto.

Como este símbolo aparece nos testes​

15 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/05_entrada_saida/i06_leia_texto_apos_leia/programa.c​

Contexto: i06_leia_texto_apos_leia. Linhas: 13. Tipo de evidência: código; via LEIA_TEXTO.

Linhas 11–15 · abrir contexto
ESCREVAL(idade);
FIM_SE
SE LEIA_TEXTO(nome, (INTEIRO) sizeof nome) ENTAO
ESCREVA("nome [");
ESCREVA_TEXTO(nome);

Ver no GitHub

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

Contexto: i07_leia_texto_limpo. Linhas: 7. Tipo de evidência: código; via LEIA_TEXTO.

Linhas 5–9 · abrir contexto
INICIO
TEXTO_FIXO(linha, 32);
SE LEIA_TEXTO(linha, (INTEIRO) sizeof linha) ENTAO
ESCREVA("[");
ESCREVA_TEXTO(linha);

Ver no GitHub

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

Contexto: i08_leia_texto_truncamento. Linhas: 9, 15. Tipo de evidência: código; via LEIA_TEXTO.

Linhas 7–11 · abrir contexto
TEXTO_FIXO(depois, 16);

SE LEIA_TEXTO(pequeno, (INTEIRO) sizeof pequeno) ENTAO
ESCREVAL("coube");
SENAO

Ver no GitHub

Linhas 13–17 · abrir contexto
FIM_SE

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

Ver no GitHub

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

Contexto: app_acervo. Linhas: 37, 45, 62. Tipo de evidência: código; via LEIA_TEXTO.

Linhas 35–39 · abrir contexto

// 1ª linha: cota de empréstimos simultâneos (inteiro)
SE NAO LEIA_TEXTO(linha, 64) ENTAO
ERRO("entrada vazia: faltou a cota de emprestimos");
FIM_SE

Ver no GitHub

Linhas 43–47 · abrir contexto

// 2ª linha: fator de raridade (real)
SE NAO LEIA_TEXTO(linha, 64) ENTAO
ERRO("faltou o fator de raridade");
FIM_SE

Ver no GitHub

Linhas 60–64 · abrir contexto

REPITA
SE NAO LEIA_TEXTO(comando, 64) ENTAO
PARE; // fim da entrada
FIM_SE

Ver no GitHub

tests/portabilidade/entrada.c​

Contexto: entrada.c. Linhas: 26, 35, 44, 61, 65, 70. Tipo de evidência: código; via LEIA_TEXTO.

Linhas 24–28 · abrir contexto

/* 2. LEIA_TEXTO depois de LEIA consome o \n pendente e lê a linha seguinte */
ok = LEIA_TEXTO(linha, TAMANHO_DE(linha));
ESCREVA_FMT("2 ok=%d linha=[%s]\n", (int) ok, linha);

Ver no GitHub

Linhas 33–37 · abrir contexto

/* 4. recuperação: a linha inválida continua no fluxo e é consumida aqui */
ok = LEIA_TEXTO(linha, TAMANHO_DE(linha));
ESCREVA_FMT("4 ok=%d linha=[%s]\n", (int) ok, linha);

Ver no GitHub

Linhas 42–46 · abrir contexto

/* 6. o resto da linha é lido como texto, com o espaço à frente */
ok = LEIA_TEXTO(linha, TAMANHO_DE(linha));
ESCREVA_FMT("6 ok=%d linha=[%s]\n", (int) ok, linha);

Ver no GitHub

Linhas 59–72 · abrir contexto

/* 10. LEIA_TEXTO com buffer pequeno: falha, destino vazio, resto consumido */
ok = LEIA_TEXTO(curto, TAMANHO_DE(curto));
ESCREVA_FMT("10 ok=%d curto=[%s]\n", (int) ok, curto);

/* 11. e o fluxo continua sincronizado na linha seguinte */
ok = LEIA_TEXTO(linha, TAMANHO_DE(linha));
ESCREVA_FMT("11 ok=%d linha=[%s]\n", (int) ok, linha);

/* 12. EOF: falha em vez de repetir a última leitura */
n = 5;
ok = LEIA_TEXTO(linha, TAMANHO_DE(linha));
ESCREVA_FMT("12 ok=%d linha=[%s]\n", (int) ok, linha);
ok = LEIA_INTEIRO(n);

Ver no GitHub

tests/run_portabilidade.sh​

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

Linhas 191–195 · abrir contexto
SE b E (i < 1) ENTAO
ESCREVAL("x");
FIM_SE
PARA (i, 0, 1) {
ESCREVA(i);

Ver no GitHub

tests/run_portabilidade.sh · heredoc na linha 183​

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

Linhas 196–199 · abrir contexto
}
ESCREVAL(ABS(-1) + MINIMO(1, 2) + DIVIDE(4, 2));
ESCREVAL(LEIA_TEXTO(buf, TAMANHO_DE(buf)));
FIM

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)

  • O tratamento explícito de CR/LF cobre a diferença de fim de linha entre Windows e Unix.

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 LEIA_TEXTO e a forma canônica BG_LEIA_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_LEIA_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_LEIA_TEXTO faz?​

BG_LEIA_TEXTO: interface macro da biblioteca. Wrapper de stdin compatível com LEIA_TEXTO, descartando um newline deixado por leitura formatada anterior.

Para que exatamente BG_LEIA_TEXTO expande?​

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

Parâmetros formais: b, t.

bg_leia_texto((b), (size_t) (t))

Como usar BG_LEIA_TEXTO em um programa?​

Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:

TEXTO_FIXO(nome, 80);
SE LEIA_TEXTO(nome, TAMANHO_DE(nome)) ENTAO
ESCREVAL(nome);
FIM_SE

Onde BG_LEIA_TEXTO é exercitado nos testes?​

Há 15 ocorrência(s) em 7 arquivo(s): tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c, tests/casos/05_entrada_saida/i07_leia_texto_limpo/programa.c, tests/casos/05_entrada_saida/i08_leia_texto_truncamento/programa.c, tests/casos/08_aplicacao/app_acervo/principal.c, tests/portabilidade/entrada.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_LEIA_TEXTO depende de compilador, padrão C ou sistema operacional?​

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

Ressalvas registradas: O tratamento explícito de CR/LF cobre a diferença de fim de linha entre Windows e Unix.

Quais armadilhas preciso evitar ao usar BG_LEIA_TEXTO?​

O contrato editorial registra: “Uma linha vazia intencional pode ser confundida com o newline pendente; prefira bg_leia_linha(stdin, ...) quando isso importar.” “Não mistura leitura de texto com scanf depois de começar a usar bg_leia_linha sem entender o estado do fluxo.”