BG_SFMT
Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:274.
Seleciona um formato scanf pelo tipo do destino, sem default.
Tipo: macro com argumentos · Módulo/categoria: Entrada e saída.
Não foi encontrado nome curto equivalente no cabeçalho atual; use a forma prefixada.
Assinatura e expansão
#define BG_SFMT(x) _Generic(&(x), \
int *: "%d", unsigned *: "%u", long *: "%ld", unsigned long *: "%lu", \
long long *: "%lld", unsigned long long *: "%llu", \
float *: "%f", double *: "%lf", long double *: "%Lf", \
char *: " %c", signed char *: " %hhd", unsigned char *: "%hhu", \
short *: "%hd", unsigned short *: "%hu")
Parâmetros formais: x.
Corpo da macro:
_Generic(&(x), \
int *: "%d", unsigned *: "%u", long *: "%ld", unsigned long *: "%lu", \
long long *: "%lld", unsigned long long *: "%llu", \
float *: "%f", double *: "%lf", long double *: "%Lf", \
char *: " %c", signed char *: " %hhd", unsigned char *: "%hhu", \
short *: "%hd", unsigned short *: "%hu")
Como funciona
_Generic opera sobre &(x), exigindo ponteiro compatível. Tipo não suportado é erro de compilação, não fallback %p.
- LOGICO, TEXTO e buffers de texto não são aceitos por LEIA; use LEIA_TEXTO para texto.
- O espaço antes de %c permite consumir whitespace pendente.
Comentário do fonte
Sem
default:de propósito (falha de tipo → erro de compilação). A versão anterior terminava emdefault: "%p", e%pfaz o scanf ESCREVER um ponteiro no destino: emLEIA(LOGICO)isso gravava 8 bytes num objeto de 1 byte (stack-buffer-overflow, visto no ASan) e emLEIA(TEXTO_FIXO(...))gravava um endereço dentro do buffer. Quem pegava o problema era só o-Wformat— um aviso, que a linha de compilação documentada no README não transforma em erro. C11 6.5.1.1p3: semdefault, um tipo de controle que não casa com nenhuma associação é violação de restrição. Ou seja, o erro passa a ser de compilação por padrão, com ou sem -Werror, nos dois compiladores testados: GCC: '_Generic' selector of type '_Bool *' is not compatible with any association Clang: controlling expression type 'bool *' not compatible with any generic association type Para ler texto use LEIA_TEXTO(buf, tam); para ler números/char, LEIA. (BG_FMT, de saída, mantémdefault: "%p": imprimir ponteiro é útil e não escreve na memória do programa.)
Interface BASICGOL relacionada
Como este símbolo aparece nos testes
Nenhuma referência direta a este nome foi encontrada nos arquivos de teste. Isso pode ser esperado para guardas de inclusão, configuração ou código exercitado indiretamente; não é uma afirmação de cobertura zero.
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.
BG_LEIA→ tests/casos/06_negativos/n16_leia_logico/programa.c, tests/casos/06_negativos/n21_leia_texto/programa.c, tests/casos/06_negativos/n22_leia_texto_fixo/programa.c, tests/casos/09_tipos_expr/t15_leia_tipos/programa.c, tests/portabilidade/entrada.cBG_LEIA_OK→ tests/casos/05_entrada_saida/i04_leia_tipos/programa.c, tests/casos/05_entrada_saida/i05_leia_falha/programa.c, tests/casos/05_entrada_saida/i06_leia_texto_apos_leia/programa.c, tests/casos/05_entrada_saida/i15_leia_caractere_apos_numero/programa.c, tests/portabilidade/entrada.c
Compiladores, padrão C e sistema operacional
Condições que envolvem a definição:
defined(BASICGOL_H)(fonte)
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. - Use a forma canônica
BG_SFMT; não há apelido curto equivalente nesta versão. - 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_SFMT. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que BG_SFMT faz?
Seleciona um formato scanf pelo tipo do destino, sem default.
Para que exatamente BG_SFMT expande?
O pré-processador substitui BG_SFMT pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.
Parâmetros formais: x.
_Generic(&(x), \
int *: "%d", unsigned *: "%u", long *: "%ld", unsigned long *: "%lu", \
long long *: "%lld", unsigned long long *: "%llu", \
float *: "%f", double *: "%lf", long double *: "%Lf", \
char *: " %c", signed char *: " %hhd", unsigned char *: "%hhu", \
short *: "%hd", unsigned short *: "%hu")
Como chamar BG_SFMT corretamente?
Nenhum exemplo editorial nem chamada direta em teste foi localizada. A forma de uso é a assinatura acima; os chamadores aparecem na seção de evidência indireta quando existem.
#define BG_SFMT(x) _Generic(&(x), \
int *: "%d", unsigned *: "%u", long *: "%ld", unsigned long *: "%lu", \
long long *: "%lld", unsigned long long *: "%llu", \
float *: "%f", double *: "%lf", long double *: "%Lf", \
char *: " %c", signed char *: " %hhd", unsigned char *: "%hhu", \
short *: "%hd", unsigned short *: "%hu")
Por que não há teste direto para BG_SFMT?
A busca estática não encontrou o identificador nos arquivos de teste. Isso é esperado para guardas de inclusão, configuração de build e nomes alcançados apenas por chamadores internos. O JSON de cobertura registra a lacuna em vez de convertê-la em aprovação.
BG_SFMT depende de compilador, padrão C ou sistema operacional?
BG_SFMT exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.
Quais armadilhas preciso evitar ao usar BG_SFMT?
O contrato editorial registra: “LOGICO, TEXTO e buffers de texto não são aceitos por LEIA; use LEIA_TEXTO para texto.” “O espaço antes de %c permite consumir whitespace pendente.”