Pular para o conteúdo principal

Entrada e saída

Nome(s)ContratoUsos diretos em testesPortabilidadeFonte
BG_AFIRME AFIRMEAvalia uma condição e emite erro fatal se ela for falsa.8 arquivo(s)condicionalfonte
BG_ERRO ERROErro fatal com localização automática do fonte do chamador.4 arquivo(s)condicionalfonte
BG_ESCREVA ESCREVAImprime um valor escalar ou texto sem acrescentar newline.30 arquivo(s)condicionalfonte
BG_ESCREVAL ESCREVALImprime um valor e acrescenta newline.137 arquivo(s)condicionalfonte
BG_ESCREVA_ERRO ESCREVA_ERROBG_ESCREVA_ERRO: interface macro da biblioteca. Escreve texto literal em um FILE, sem interpretar formatos printf.1 arquivo(s)condicionalfonte
BG_ESCREVA_FMT ESCREVA_FMTAcesso direto a printf para formatação de múltiplos valores.21 arquivo(s)condicionalfonte
BG_ESCREVA_LINHA ESCREVA_LINHAEmite somente um newline em stdout.17 arquivo(s)condicionalfonte
BG_ESCREVA_TEXTO ESCREVA_TEXTOBG_ESCREVA_TEXTO: interface macro da biblioteca. Escreve texto literal em um FILE, sem interpretar formatos printf.7 arquivo(s)condicionalfonte
BG_FMTSeleciona um formato printf em tempo de compilação pelo tipo do valor.0 arquivo(s)condicionalfonte
BG_LEIA LEIALê um valor escalar com scanf e descarta explicitamente o indicador de sucesso.5 arquivo(s)condicionalfonte
BG_LEIA_INTEIRO LEIA_INTEIROBG_LEIA_INTEIRO: interface macro da biblioteca. Lê uma linha de stdin e converte exatamente um inteiro decimal para int.4 arquivo(s)condicionalfonte
BG_LEIA_OK LEIA_OKLê um valor escalar e informa se scanf converteu exatamente um item.5 arquivo(s)condicionalfonte
BG_LEIA_REAL LEIA_REALBG_LEIA_REAL: interface macro da biblioteca. Lê uma linha de stdin e converte exatamente um número real para double.2 arquivo(s)condicionalfonte
BG_LEIA_TEXTO LEIA_TEXTOBG_LEIA_TEXTO: interface macro da biblioteca. Wrapper de stdin compatível com LEIA_TEXTO, descartando um newline deixado por leitu7 arquivo(s)condicionalfonte
BG_SFMTSeleciona um formato scanf pelo tipo do destino, sem default.0 arquivo(s)condicionalfonte

Perguntas frequentes​

Perguntas frequentes sobre a família “Entrada e saída”, respondidas com as definições e os usos que o gerador encontrou no repositório.

Quais nomes pertencem a “Entrada e saída”?​

Esta família reúne 15 contrato(s): BG_AFIRME, BG_ERRO, BG_ESCREVA, BG_ESCREVAL, BG_ESCREVA_ERRO, BG_ESCREVA_FMT, BG_ESCREVA_LINHA, BG_ESCREVA_TEXTO, BG_FMT, BG_LEIA, BG_LEIA_INTEIRO, BG_LEIA_OK e mais 3. As formas curtas incluem ERRO, AFIRME, ESCREVA, ESCREVAL, ESCREVA_LINHA, ESCREVA_TEXTO, ESCREVA_FMT, ESCREVA_ERRO, LEIA, LEIA_OK.

Como colocar um destes nomes no meu programa?​

Inclua o cabeçalho uma única vez e compile em C11. Não é necessário declarar nada à mão: cada nome é macro do cabeçalho.

Trecho de BG_ESCREVA_ERRO:

#include <basicgol.h>

ESCREVA_TEXTO("100% literal\n");

Qual é a diferença entre a forma curta e a forma BG_*?​

São o mesmo nome: a forma curta é um alias textual da canônica e ambas são reunidas na mesma página de referência. Os testes de qualquer alias contam como evidência da macro.

BG_ESCREVA_ERRO /* forma canônica */
ESCREVA_ERRO /* alias equivalente */

Estes nomes funcionam fora de C11?​

Não. O cabeçalho recusa C99/C89 com mensagem explícita e usa _Generic para selecionar formatos e divisões. Compiladores e sistemas operacionais continuam sendo os do alvo; consulte a matriz de compatibilidade.

Como uma macro desta família aparece em uso real?​

Trecho de tests/casos/05_entrada_saida/i13_afirme_ok/programa.c:4:

INICIO
INTEIRO total = 10;
AFIRME(total > 0, "total deve ser positivo");
ESCREVAL("contrato ok");
FIM