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
Public Class Methods
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 45 def self.from_bson(buffer, **options) value = buffer.get_int64 if options[:mode] == :bson new(value) else value end end
@param [ Integer ] value The 64-bit integer.
@see bsonspec.org/#/specification
@since 4.2.0
# File lib/bson/int64.rb, line 61 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
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 113 def ==(other) return false unless other.is_a?(Int64) value == other.value end
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 130 def as_extended_json(**options) if options[:mode] == :relaxed || options[:mode] == :legacy value else {'$numberLong' => value.to_s} end end
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 88 def to_bson(buffer = ByteBuffer.new, validating_keys = Config.validating_keys?) buffer.put_int64(value) end
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 102 def to_bson_key(validating_keys = Config.validating_keys?) value end