module BSON::Float

Injects behaviour for encoding and decoding floating point values to and from # raw bytes as specified by the BSON spec.

@see bsonspec.org/#/specification

@since 2.0.0

Constants

BSON_TYPE

A floating point is type 0x01 in the BSON spec.

@since 2.0.0

PACK

The pack directive is for 8 byte floating points.

@since 2.0.0

Public Instance Methods

as_extended_json(**options) click to toggle source

Converts this object to a representation directly serializable to Extended JSON (github.com/mongodb/specifications/blob/master/source/extended-json.rst).

This method returns the float itself if relaxed representation is requested and the value is finite, otherwise a $numberDouble hash.

@option opts [ nil | :relaxed | :legacy ] :mode Serialization mode

(default is canonical extended JSON)

@return [ Hash | Float ] The extended json representation.

# File lib/bson/float.rb, line 59
def as_extended_json(**options)
  case infinite?
  when 1
    {'$numberDouble' => 'Infinity'}
  when -1
    {'$numberDouble' => '-Infinity'}
  else
    if nan?
      {'$numberDouble' => 'NaN'}
    else
      if options[:mode] == :relaxed || options[:mode] == :legacy
        self
      else
        value = if BSON::Environment.jruby?
          # Hack to make bson corpus spec tests pass.
          # JRuby serializes -1.2345678901234568e+18 as
          # -1234567890123456770.0, which is valid but differs from MRI
          # serialization. Extended JSON spec does not define precise
          # stringification of floats.
          # https://jira.mongodb.org/browse/SPEC-1536
          if abs > 1e15
            '%.17g' % to_s
          else
            to_s
          end
        else
          to_s
        end
        {'$numberDouble' => value.upcase}
      end
    end
  end
end
to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?) click to toggle source

Get the floating point as encoded BSON.

@example Get the floating point as encoded BSON.

1.221311.to_bson

@return [ BSON::ByteBuffer ] The buffer with the encoded object.

@see bsonspec.org/#/specification

@since 2.0.0

# File lib/bson/float.rb, line 45
def to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?)
  buffer.put_double(self)
end