Utilidades e sorteio
| Função | Visibilidade | Resumo | Arquivos de teste | Fonte |
|---|---|---|---|---|
bg_inicia_sorteio | pública | Define a semente do gerador pseudoaleatório global de forma reprodutível. | 2 | fonte |
bg_prng_proximo | interna (static) | Avança o estado global xorshift64 e devolve 64 bits pseudoaleatórios. | 0 | fonte |
bg_sorteia | pública | Wrapper de compatibilidade de SORTEIA(n): devolve um inteiro em [0,n), ou zero para n não positivo. | 2 | fonte |
bg_sorteia_ate | pública | Sorteia uniformemente no intervalo [0, limite_exclusivo), removendo o viés do módulo por rejeição. | 4 | fonte |
Perguntas frequentes
Perguntas frequentes sobre o módulo “Utilidades e sorteio”, com assinaturas, receita de build e limites de erro extraídos do fonte.
O que o módulo “Utilidades e sorteio” oferece?
4 função(ões): bg_inicia_sorteio, bg_prng_proximo, bg_sorteia, bg_sorteia_ate. 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_inicia_sorteio:
#include <basicgol.h>
#include "include/basicgol/utilidades.h"
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -o programa
void bg_inicia_sorteio(unsigned semente)
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/portabilidade/fronteira.c:268:
EXIGE(bg_sorteia_ate((unsigned) RAND_MAX + 1u, &valor) == true);
bg_inicia_sorteio(12345u);
for (i = 0; i < 200; i++) {
if (!bg_sorteia_ate(7u, &valor)) {