ratioDecimalFixedPoint

function ratioDecimalFixedPoint<TSignedness, TTotalBits, TDecimals>(
    signedness,
    totalBits,
    decimals,
): (
    numerator,
    denominator,
    rounding?,
) => DecimalFixedPoint<TSignedness, TTotalBits, TDecimals>;

Returns a factory that constructs DecimalFixedPoint values from a rational numerator / denominator.

The outer call validates the shape parameters once and the returned factory can be called many times to construct values of that shape.

If the ratio cannot be exactly represented at the target decimals, the returned factory throws SOLANA_ERROR__FIXED_POINTS__STRICT_MODE_PRECISION_LOSS under the default 'strict' rounding mode. Pass a different RoundingMode to allow a rounded result. Zero denominators always throw SOLANA_ERROR__FIXED_POINTS__INVALID_ZERO_DENOMINATOR_RATIO.

Type Parameters

Parameters

Returns

(
   numerator,
   denominator,
rounding?): DecimalFixedPoint<TSignedness, TTotalBits, TDecimals>;

Parameters

Returns

DecimalFixedPoint<TSignedness, TTotalBits, TDecimals>

Example

const probability = ratioDecimalFixedPoint('unsigned', 64, 4);
probability(1n, 4n);           // raw === 2500n (0.2500)
probability(1n, 3n);           // throws under 'strict'
probability(1n, 3n, 'floor');  // raw === 3333n

See

• DecimalFixedPoint
• decimalFixedPoint
• rawDecimalFixedPoint