bg_leia_real
Gerada por tools/gerar_documentacao.py. Definição: src/biblioteca/consola.c:149.
Lê uma linha de stdin e converte exatamente um número real para double.
Tipo: função C · Visibilidade: pública · Arquivo: src/biblioteca/consola.c.
Assinatura e expansão
bool bg_leia_real(double *saida)
Parâmetros formais: double *saida.
Declarações públicas localizadas:
Lê e escreve uma linha de stdin para double; falha não altera
saida.
Como funciona
Lê a linha com a compatibilidade de newline de bg_leia_texto e delega a bg_texto_para_real. Rejeita sobra não whitespace e estouro sinalizado pela libc.
Retorno: true em sucesso; false não altera o double de saída.
Exemplo de uso
REAL media = 0.0;
SE LEIA_REAL(media) ENTAO ESCREVAL(media); FIM_SE
Implementação
{
char linha[BG_TAMANHO_LINHA_NUMERO];
if (saida == NULL || !bg_leia_texto(linha, sizeof linha)) {
return false;
}
return bg_texto_para_real(linha, saida);
}
Interface BASICGOL relacionada
Nomes internos referenciados: bg_leia_texto, bg_texto_para_real.
Como este símbolo aparece nos testes
3 ocorrência(s) em 2 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/portabilidade/fronteira.c
Contexto: fronteira.c. Linhas: 298. Tipo de evidência: código; via bg_leia_real.
Linhas 296–300 · abrir contexto
EXIGE(bg_leia_linha(stdin, dst, 0) == false);
EXIGE(bg_leia_inteiro(NULL) == false);
EXIGE(bg_leia_real(NULL) == false);
}
tests/test_biblioteca.c
Contexto: testa_stdin_compativel, testa_stdin_invalido. Linhas: 426, 440. Tipo de evidência: código; via bg_leia_real.
Linhas 424–428 · abrir contexto
|| strcmp(linha, "linha de texto") != 0
|| !bg_leia_inteiro(&inteiro) || inteiro != -7
|| !bg_leia_real(&real) || real != 3.5) {
(void) fprintf(stderr, "falha nos wrappers de stdin\n");
return 1;
Linhas 438–442 · abrir contexto
if (bg_leia_inteiro(&inteiro) || inteiro != 71
|| bg_leia_real(&real) || real != 8.25) {
(void) fprintf(stderr, "falha nos wrappers numericos invalidos\n");
return 1;
Modos de integração/falha fatal
--stdin— invocação L42:if printf '42\nlinha de texto\n-7\n3.5\n' | "$TESTE" --stdin > "$TMP/out" 2> "$TMP/err" \--stdin-invalido— invocação L50:if printf 'abc\n1e9999\n' | "$TESTE" --stdin-invalido > "$TMP/out" 2> "$TMP/err" \
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
Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.
- strtod usa a locale C corrente. O projeto não chama setlocale; se a aplicação mudar a locale, o separador decimal pode mudar.
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. - Declare pelo cabeçalho (
include/basicgol/consola.h) e liguebuild/libbasicgol.a; não copie o corpo desrc/biblioteca/consola.cpara o seu arquivo. - 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_leia_real. 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_real faz?
Lê uma linha de stdin e converte exatamente um número real para double.
Qual é a assinatura e o tipo de retorno de bg_leia_real?
Assinatura extraída de src/biblioteca/consola.c; visibilidade pública.
Retorno: true em sucesso; false não altera o double de saída.
bool bg_leia_real(double *saida)
Como usar bg_leia_real em um programa?
Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:
REAL media = 0.0;
SE LEIA_REAL(media) ENTAO ESCREVAL(media); FIM_SE
Onde bg_leia_real é exercitado nos testes?
Há 3 ocorrência(s) em 2 arquivo(s): tests/portabilidade/fronteira.c, tests/test_biblioteca.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_real depende de compilador, padrão C ou sistema operacional?
bg_leia_real exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Ressalvas registradas: strtod usa a locale C corrente. O projeto não chama setlocale; se a aplicação mudar a locale, o separador decimal pode mudar.
O que acontece em caso de falha ou uso inválido?
true em sucesso; false não altera o double de saída.