Caffeine

Aleatório

Reference Core Última atualização: Lua 5 · Dryad 5

Um gerador determinístico: a mesma semente dá sempre a mesma sequência, em todas as plataformas.

Todos os namespaces

Namespace: caffeine.random · Dryad prefix: caffeine_random_

setSeed#

Lua: caffeine.random.setSeed · Dryad: caffeine_random_set_seed

text
setSeed(seed)

Reinicia a sequência.

ParâmetrosTipoDescrição
seednumberQualquer inteiro; 0 é substituído por um valor fixo.

Devolve: nada

Exemplo

lua
caffeine.random.setSeed(1234)

value#

Lua: caffeine.random.value · Dryad: caffeine_random_value

text
value() -> number

Próximo número aleatório.

Devolve: number. Um número em [0, 1).

Exemplo

lua
local r = caffeine.random.value()

range#

Lua: caffeine.random.range · Dryad: caffeine_random_range

text
range(min, max) -> number

Um número aleatório num intervalo.

ParâmetrosTipoDescrição
minnumberLimite inferior (inclusivo).
maxnumberLimite superior (exclusivo).

Devolve: number. Um número em [min, max).

Exemplo

lua
local x = caffeine.random.range(-5, 5)

int#

Lua: caffeine.random.int · Dryad: caffeine_random_int

text
int(min, max) -> number

Um inteiro aleatório, com os dois extremos incluídos.

ParâmetrosTipoDescrição
minnumberLimite inferior (inclusivo).
maxnumberLimite superior (inclusivo); limites invertidos são trocados.

Devolve: number. Um inteiro em [min, max].

Exemplo

lua
local roll = caffeine.random.int(1, 6)

chance#

Lua: caffeine.random.chance · Dryad: caffeine_random_chance

text
chance(p) -> boolean

Um cara ou coroa com pesos.

ParâmetrosTipoDescrição
pnumberProbabilidade de 0 a 1.

Devolve: boolean. true com probabilidade p.

Exemplo

lua
if caffeine.random.chance(0.25) then end