Pular para o conteúdo principal

Console e diagnóstico

FunçãoVisibilidadeResumoArquivos de testeFonte
bg_erropúblicaEmite um diagnóstico padronizado em stderr e encerra o processo com status 1; não retorna ao chamador.1fonte
bg_escreva_linhapúblicaEscreve texto literal seguido de LF em um FILE.2fonte
bg_escreva_textopúblicaEscreve texto literal em um FILE, sem interpretar formatos printf.2fonte
bg_leia_inteiropúblicaLê uma linha de stdin e converte exatamente um inteiro decimal para int.2fonte
bg_leia_inteiro_depúblicaVersão de bg_leia_inteiro que recebe um FILE explícito.1fonte
bg_leia_linhapúblicaLê uma linha inteira de um FILE para um buffer limitado, sem perder a sincronização do fluxo em linha longa.2fonte
bg_leia_realpúblicaLê uma linha de stdin e converte exatamente um número real para double.2fonte
bg_leia_real_depúblicaVersão de bg_leia_real que recebe um FILE explícito.1fonte
bg_leia_textopúblicaWrapper de stdin compatível com LEIA_TEXTO, descartando um newline deixado por leitura formatada anterior.1fonte
bg_passo_zeropúblicaDiagnóstico fatal de PARA_PASSO quando o passo é zero.1fonte

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