Class Decimal128

constructor

• new Decimal128(bytes): Decimal128

• Parameters

  • bytes: string | Uint8Array

    a buffer containing the raw Decimal128 bytes in little endian order, or a string representation as returned by .toString()

  Returns Decimal128

Readonly bytes

_bsontype

• get _bsontype(): "Decimal128"

• Returns "Decimal128"

inspect

• inspect(depth?, options?, inspect?): string

• Prints a human-readable string of BSON value information If invoked manually without node.js.inspect function, this will default to a modified JSON.stringify

  Parameters

  • Optional depth: number

  • Optional options: unknown

  • Optional inspect: InspectFn

  Returns string

toJSON

• toJSON(): Decimal128Extended

• Returns Decimal128Extended

toString

• toString(): string

• Create a string representation of the raw Decimal128 value

  Returns string

Static fromString

• fromString(representation): Decimal128

• Create a Decimal128 instance from a string representation

  Parameters

  • representation: string

    a numeric string representation.

  Returns Decimal128

Static fromStringWithRounding

• fromStringWithRounding(representation): Decimal128

• Create a Decimal128 instance from a string representation, allowing for rounding to 34 significant digits

  Parameters

  • representation: string

    a numeric string representation.

  Returns Decimal128

  Example

  Example of a number that will be rounded

  > let d = Decimal128.fromString('37.499999999999999196428571428571375')
  Uncaught:
  BSONError: "37.499999999999999196428571428571375" is not a valid Decimal128 string - inexact rounding
  at invalidErr (/home/wajames/js-bson/lib/bson.cjs:1402:11)
  at Decimal128.fromStringInternal (/home/wajames/js-bson/lib/bson.cjs:1633:25)
  at Decimal128.fromString (/home/wajames/js-bson/lib/bson.cjs:1424:27)
  
  > d = Decimal128.fromStringWithRounding('37.499999999999999196428571428571375')
  new Decimal128("37.49999999999999919642857142857138")
  Copy