class BSON::Int64

Represents int64 type.

@see bsonspec.org/#/specification

@since 2.0.0

Constants

BSON_TYPE

A boolean is type 0x08 in the BSON spec.

@since 2.0.0

PACK

Constant for the int 64 pack directive.

@since 2.0.0

Attributes

value[R]

Returns the value of this Int64.

@return [ Integer ] The integer value.

Public Class Methods

from_bson(buffer, **options) click to toggle source

Deserialize an Integer from BSON.

@param [ ByteBuffer ] buffer The byte buffer.

@option options [ nil | :bson ] :mode Decoding mode to use.

@return [ Integer | BSON::Int64 ] The decoded Integer.

@see bsonspec.org/#/specification

@since 2.0.0

# File lib/bson/int64.rb, line 46
def self.from_bson(buffer, **options)
  value = buffer.get_int64
  if options[:mode] == :bson
    new(value)
  else
    value
  end
end
new(value) click to toggle source

Instantiate a BSON Int64.

@param [ Integer ] value The 64-bit integer.

@see bsonspec.org/#/specification

@since 4.2.0

# File lib/bson/int64.rb, line 62
def initialize(value)
  if value.is_a?(self.class)
    @value = value.value
    return
  end

  unless value.bson_int64?
    raise RangeError.new("#{value} cannot be stored in 64 bits")
  end
  @value = value.freeze
end

Public Instance Methods

==(other) click to toggle source

Check equality of the int64 with another object.

@param [ Object ] other The object to check against.

@return [ true, false ] If the objects are equal.

@since 4.4.0

# File lib/bson/int64.rb, line 114
def ==(other)
  return false unless other.is_a?(Int64)
  value == other.value
end
Also aliased as: eql?, ===
===(other)
Alias for: ==
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 integer value if relaxed representation is requested, otherwise a $numberLong hash.

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

(default is canonical extended JSON)

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

# File lib/bson/int64.rb, line 131
def as_extended_json(**options)
  if options[:mode] == :relaxed || options[:mode] == :legacy
    value
  else
    {'$numberLong' => value.to_s}
  end
end
eql?(other)
Alias for: ==
to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?) click to toggle source

Append the integer as encoded BSON to a ByteBuffer.

@example Encoded the integer and append to a ByteBuffer.

int64.to_bson

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

@see bsonspec.org/#/specification

@since 4.2.0

# File lib/bson/int64.rb, line 89
def to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?)
  buffer.put_int64(value)
end
to_bson_key(validating_keys = Config.validating_keys?) click to toggle source

Convert the integer to a BSON string key.

@example Convert the integer to a BSON key string.

int.to_bson_key

@param [ true, false ] validating_keys If BSON should validate the key.

@return [ String ] The string key.

@since 4.2.0

# File lib/bson/int64.rb, line 103
def to_bson_key(validating_keys = Config.validating_keys?)
  value
end