Pular para o conteúdo principal

Utilidades e sorteio

FunçãoVisibilidadeResumoArquivos de testeFonte
bg_inicia_sorteiopúblicaDefine a semente do gerador pseudoaleatório global de forma reprodutível.2fonte
bg_prng_proximointerna (static)Avança o estado global xorshift64 e devolve 64 bits pseudoaleatórios.0fonte
bg_sorteiapúblicaWrapper de compatibilidade de SORTEIA(n): devolve um inteiro em [0,n), ou zero para n não positivo.2fonte
bg_sorteia_atepúblicaSorteia uniformemente no intervalo [0, limite_exclusivo), removendo o viés do módulo por rejeição.4fonte

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