Method fromString

src.ts/utils/fixednumber.ts:595–619

* Creates a new [[FixedNumber]] for %%value%% with %%format%%. * * This will throw a [[NumericFaultError]] if %%value%% cannot fit * in %%format%%, either due to overflow or underflow (precision loss).

(_value: string, _format?: FixedFormat)

     *  in %%format%%, either due to overflow or underflow (precision loss).
     */
    static fromString(_value: string, _format?: FixedFormat): FixedNumber {
        const match = _value.match(/^(-?)([0-9]*)\.?([0-9]*)$/);
        assertArgument(match && (match[2].length + match[3].length) > 0, "invalid FixedNumber string value", "value", _value);

        const format = getFormat(_format);

        let whole = (match[2] || "0"), decimal = (match[3] || "");

        // Pad out the decimals
        while (decimal.length < format.decimals) { decimal += Zeros; }

        // Check precision is safe
        assert(decimal.substring(format.decimals).match(/^0*$/), "too many decimals for format", "NUMERIC_FAULT", {
            operation: "fromString", fault: "underflow", value: _value
        });

        // Remove extra padding
        decimal = decimal.substring(0, format.decimals);

        const value = BigInt(match[1] + whole + decimal)

        checkValue(value, format, "fromString");

        return new FixedNumber(_guard, value, format);
    }

    /**
     *  Creates a new [[FixedNumber]] with the big-endian representation