Sha256: 770222bbc83885ac3eaa9599ce1cc81cb8096ad117346c857d004d8b6d3e5b5a

Contents?: true

Size: 1.69 KB

Versions: 26

Compression:

Stored size: 1.69 KB

Contents

# Copyright (C) 2009-2013 MongoDB, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require 'bson/byte_buffer'

module BSON

  # An array of binary bytes with a MongoDB subtype. See the subtype
  # constants for reference.
  #
  # Use this class when storing binary data in documents.
  class Binary < ByteBuffer

    SUBTYPE_SIMPLE       = 0x00
    SUBTYPE_BYTES        = 0x02
    SUBTYPE_UUID         = 0x03
    SUBTYPE_MD5          = 0x05
    SUBTYPE_USER_DEFINED = 0x80

    # One of the SUBTYPE_* constants. Default is SUBTYPE_BYTES.
    attr_accessor :subtype

    # Create a buffer for storing binary data in MongoDB.
    #
    # @param [Array, String] data to story as BSON binary. If a string is given, the on
    #   Ruby 1.9 it will be forced to the binary encoding.
    # @param [Fixnum] subtype one of four values specifying a BSON binary subtype. Possible values are
    #   SUBTYPE_BYTES, SUBTYPE_UUID, SUBTYPE_MD5, and SUBTYPE_USER_DEFINED.
    #
    # @see http://www.mongodb.org/display/DOCS/BSON#BSON-noteondatabinary BSON binary subtypes.
    def initialize(data=[], subtype=SUBTYPE_SIMPLE)
      super(data)
      @subtype = subtype
    end

    def inspect
      "<BSON::Binary:#{object_id}>"
    end

  end
end

Version data entries

26 entries across 26 versions & 1 rubygems

Version Path
bson-1.12.5-java lib/bson/types/binary.rb
bson-1.12.5 lib/bson/types/binary.rb
bson-1.12.4-java lib/bson/types/binary.rb
bson-1.12.4 lib/bson/types/binary.rb
bson-1.12.3-java lib/bson/types/binary.rb
bson-1.12.3 lib/bson/types/binary.rb
bson-1.12.2-java lib/bson/types/binary.rb
bson-1.12.2 lib/bson/types/binary.rb
bson-1.12.1-java lib/bson/types/binary.rb
bson-1.12.1 lib/bson/types/binary.rb
bson-1.12.0-java lib/bson/types/binary.rb
bson-1.12.0 lib/bson/types/binary.rb
bson-1.12.0.rc2-java lib/bson/types/binary.rb
bson-1.12.0.rc2 lib/bson/types/binary.rb
bson-1.12.0.rc1-java lib/bson/types/binary.rb
bson-1.12.0.rc1 lib/bson/types/binary.rb
bson-1.12.0.rc0 lib/bson/types/binary.rb
bson-1.12.0.rc0-java lib/bson/types/binary.rb
bson-1.11.1 lib/bson/types/binary.rb
bson-1.11.1-java lib/bson/types/binary.rb