Console e diagnóstico
| Função | Visibilidade | Resumo | Arquivos de teste | Fonte |
|---|---|---|---|---|
bg_erro | pública | Emite um diagnóstico padronizado em stderr e encerra o processo com status 1; não retorna ao chamador. | 1 | fonte |
bg_escreva_linha | pública | Escreve texto literal seguido de LF em um FILE. | 2 | fonte |
bg_escreva_texto | pública | Escreve texto literal em um FILE, sem interpretar formatos printf. | 2 | fonte |
bg_leia_inteiro | pública | Lê uma linha de stdin e converte exatamente um inteiro decimal para int. | 2 | fonte |
bg_leia_inteiro_de | pública | Versão de bg_leia_inteiro que recebe um FILE explícito. | 1 | fonte |
bg_leia_linha | pública | Lê uma linha inteira de um FILE para um buffer limitado, sem perder a sincronização do fluxo em linha longa. | 2 | fonte |
bg_leia_real | pública | Lê uma linha de stdin e converte exatamente um número real para double. | 2 | fonte |
bg_leia_real_de | pública | Versão de bg_leia_real que recebe um FILE explícito. | 1 | fonte |
bg_leia_texto | pública | Wrapper de stdin compatível com LEIA_TEXTO, descartando um newline deixado por leitura formatada anterior. | 1 | fonte |
bg_passo_zero | pública | Diagnóstico fatal de PARA_PASSO quando o passo é zero. | 1 | fonte |
Perguntas frequentes
Perguntas frequentes sobre o módulo “Console e diagnóstico”, com assinaturas, receita de build e limites de erro extraídos do fonte.
O que o módulo “Console e diagnóstico” oferece?
10 função(ões): bg_erro, bg_escreva_linha, bg_escreva_texto, bg_leia_inteiro, bg_leia_inteiro_de, bg_leia_linha, bg_leia_real, bg_leia_real_de, bg_leia_texto, bg_passo_zero. Todas têm protótipo público no cabeçalho do módulo e implementação em src/biblioteca/.
Como compilar e ligar um programa que usa este módulo?
Inclua basicgol.h e o cabeçalho do módulo e ligue build/libbasicgol.a. No caminho GCC/Clang, funções de libm também pedem -lm.
Assinatura real de bg_erro:
#include <basicgol.h>
#include "include/basicgol/consola.h"
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -o programa
_Noreturn void bg_erro(const char *arquivo, int linha, const char *mensagem)
As funções devolvem erro ou encerram o programa?
Depende do contrato: operações recuperáveis devolvem LOGICO e preservam a saída em falha; violações fatais documentadas (por exemplo divisor zero em DIVIDE e passo zero em PARA_PASSO) chamam ERRO e terminam com status 1. Cada página de função mostra Retorno e Contrato e armadilhas.
Como conferir este módulo antes de integrar?
A biblioteca tem suíte unitária própria, além dos casos dourados da linguagem.
make test-biblioteca
make test
make test-portabilidade
Como este módulo aparece em teste real?
Trecho de tests/test_biblioteca.c:465:
{
if (strcmp(caso, "erro") == 0) {
bg_erro("teste.c", 37, "falha esperada");
} else if (strcmp(caso, "passo") == 0) {
(void) bg_passo_zero("teste.c", 38);