Pular para o conteúdo principal

BG_SFMT

Página gerada do fonte

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.

Contrato e armadilhas
  • 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 em default: "%p", e %p faz o scanf ESCREVER um ponteiro no destino: em LEIA(LOGICO) isso gravava 8 bytes num objeto de 1 byte (stack-buffer-overflow, visto no ASan) e em LEIA(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: sem default, 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ém default: "%p": imprimir ponteiro é útil e não escreve na memória do programa.)

Interface BASICGOL relacionada​

BG_LEIA, BG_LEIA_OK

Como este símbolo aparece nos testes​

Sem uso direto localizado

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.

Compiladores, padrão C e sistema operacional​

Condições que envolvem a definição:

  • defined(BASICGOL_H) (fonte)
Não confunda implementação com certificação

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 (ou make test-biblioteca para 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.”