Funções
Todas as funções de tyrus:math operam em f64 salvo indicação contrária e são emitidas como chamadas nativas diretas.
Básicas e sinais
| Função | Assinatura | Descrição |
|---|---|---|
abs | (x: f64) => f64 | Valor absoluto |
sign | (x: f64) => f64 | Sinal (1, -1 ou 0) |
sqrt | (x: f64) => f64 | Raiz quadrada |
cbrt | (x: f64) => f64 | Raiz cúbica |
Arredondamento
| Função | Assinatura | Descrição |
|---|---|---|
floor | (x: f64) => f64 | Arredonda para baixo |
ceil | (x: f64) => f64 | Arredonda para cima |
trunc | (x: f64) => f64 | Trunca em direção a zero |
round | (x: f64) => f64 | Arredonda para o inteiro mais próximo |
roundTo | (x: f64, decimals: i32) => f64 | Arredonda para N casas decimais |
Trigonometria
| Função | Assinatura | Descrição |
|---|---|---|
sin | (x: f64) => f64 | Seno |
cos | (x: f64) => f64 | Cosseno |
tan | (x: f64) => f64 | Tangente |
asin | (x: f64) => f64 | Arco seno |
acos | (x: f64) => f64 | Arco cosseno |
atan | (x: f64) => f64 | Arco tangente |
atan2 | (y: f64, x: f64) => f64 | Arco tangente de y/x |
degToRad | (degrees: f64) => f64 | Converte graus para radianos |
radToDeg | (radians: f64) => f64 | Converte radianos para graus |
Hiperbólicas
| Função | Assinatura | Descrição |
|---|---|---|
sinh | (x: f64) => f64 | Seno hiperbólico |
cosh | (x: f64) => f64 | Cosseno hiperbólico |
tanh | (x: f64) => f64 | Tangente hiperbólica |
Exponenciais e logaritmos
| Função | Assinatura | Descrição |
|---|---|---|
exp | (x: f64) => f64 | e^x |
log | (x: f64) => f64 | Logaritmo natural |
log10 | (x: f64) => f64 | Logaritmo base 10 |
log2 | (x: f64) => f64 | Logaritmo base 2 |
pow | (base: f64, exp: f64) => f64 | Potência |
Seleção e baixo nível
| Função | Assinatura | Descrição |
|---|---|---|
max | (a: f64, b: f64) => f64 | Máximo |
min | (a: f64, b: f64) => f64 | Mínimo |
clamp | (value: f64, min: f64, max: f64) => f64 | Limita valor ao intervalo |
clampMin | (value: f64, min: f64) => f64 | Garante valor mínimo |
clampMax | (value: f64, max: f64) => f64 | Garante valor máximo |
imul | (a: i32, b: i32) => i32 | Multiplicação C-style 32-bit |
clz32 | (x: i32) => i32 | Conta bits zero à esquerda em inteiro 32-bit |
Utilitários avançados
| Função | Assinatura | Descrição |
|---|---|---|
approxEqual | (a: f64, b: f64, tolerance?: f64) => boolean | Compara floats dentro da tolerância |
lerp | (start: f64, end: f64, amount: f64) => f64 | Interpolação linear |
inverseLerp | (start: f64, end: f64, value: f64) => f64 | Interpolação linear inversa |
remap | (value: f64, inMin: f64, inMax: f64, outMin: f64, outMax: f64) => f64 | Remapeia valor entre escalas |
smoothstep | (edge0: f64, edge1: f64, x: f64) => f64 | Interpolação suave de Hermite |
gcd | (a: u32, b: u32) => u32 | Máximo divisor comum |
lcm | (a: u32, b: u32) => u32 | Mínimo múltiplo comum |
randomRange | (min: f64, max: f64) => f64 | Float aleatório no intervalo semiaberto |
Estatística e combinatória
| Função | Assinatura | Descrição |
|---|---|---|
mean | (values: f64[]) => f64 | Média aritmética; 0.0 para array vazia |
median | (values: f64[]) => f64 | Mediana; 0.0 para array vazia |
mode | (values: f64[]) => f64 | Valor mais frequente; 0.0 para array vazia |
variance | (values: f64[]) => f64 | Variância populacional; 0.0 para array vazia |
stdDev | (values: f64[]) => f64 | Desvio padrão populacional; 0.0 para array vazia |
percentile | (p: f64, values: f64[]) => f64 | Percentil p (0-100) com interpolação linear; 0.0 para array vazia |
factorial | (n: u128) => u128 | n! |
permutation | (n: u128, k: u128) => u128 | n! / (n - k)! |
combination | (n: u128, k: u128) => u128 | n! / (k! * (n - k)!) |
Teoria dos números
| Função | Assinatura | Descrição |
|---|---|---|
isPrime | (n: u64) => boolean | true se n é primo |
nextPrime | (n: u64) => u64 | Menor primo estritamente maior que n |
primeFactors | (n: u64) => u64[] | Fatores primos de n |
fibonacci | (n: u64) => u64 | n-ésimo número de Fibonacci |
Geometria e utilitários numéricos
| Função | Assinatura | Descrição |
|---|---|---|
hypot | (x: f64, y: f64) => f64 | Norma Euclidiana sqrt(x^2 + y^2) |
toPolar | (x: f64, y: f64) => [f64, f64] | Converte Cartesianas para polares (r, theta) |
toCartesian | (r: f64, theta: f64) => [f64, f64] | Converte polares para Cartesianas (x, y) |
copysign | (x: f64, y: f64) => f64 | Copia sinal de y para x |
fmod | (x: f64, y: f64) => f64 | Resto floating-point de x / y |
logBase | (x: f64, base: f64) => f64 | Logaritmo de x na base dada |
powi | (x: f64, exp: i32) => f64 | x elevado à potência inteira exp |
