Sha256: cab4bab28e6ad257f8a7a08cb5737f65a44a2feb857839e923613d31fb06c716

Contents?: true

Size: 1.83 KB

Versions: 16

Compression:

Stored size: 1.83 KB

Contents

# encoding: utf-8

module AMQ
  # Very minimalistic, pure Ruby implementation of bit set. Inspired by java.util.BitSet,
  # although significantly smaller in scope.
  #
  # Originally part of amqp gem. Extracted to make it possible for Bunny to use it.
  class BitSet

    #
    # API
    #

    ADDRESS_BITS_PER_WORD = 6
    BITS_PER_WORD         = (1 << ADDRESS_BITS_PER_WORD)
    WORD_MASK             = 0xffffffffffffffff

    # @param [Integer] Number of bits in the set
    # @api public
    def initialize(nbits)
      @nbits = nbits

      self.init_words(nbits)
    end # initialize(nbits)

    # Sets (flags) given bit. This method allows bits to be set more than once in a row, no exception will be raised.
    #
    # @param [Integer] A bit to set
    # @api public
    def set(i)
      w = self.word_index(i)
      @words[w] |= (1 << i)
    end # set(i)

    # Fetches flag value for given bit.
    #
    # @param [Integer] A bit to fetch
    # @return [Boolean] true if given bit is set, false otherwise
    # @api public
    def get(i)
      w = self.word_index(i)

      (@words[w] & (1 << i)) != 0
    end # get(i)
    alias [] get

    # Unsets (unflags) given bit. This method allows bits to be unset more than once in a row, no exception will be raised.
    #
    # @param [Integer] A bit to unset
    # @api public
    def unset(i)
      w = self.word_index(i)
      return if w.nil?

      @words[w] &= ~(1 << i)
    end # unset(i)

    # Clears all bits in the set
    # @api public
    def clear
      self.init_words(@nbits)
    end # clear


    #
    # Implementation
    #

    protected

    # @private
    def init_words(nbits)
      n      = word_index(nbits-1) + 1
      @words = Array.new(n) { 1 }
    end # init_words

    # @private
    def word_index(i)
      i >> ADDRESS_BITS_PER_WORD
    end # word_index(i)
  end # BitSet
end # AMQ

Version data entries

16 entries across 16 versions & 1 rubygems

Version Path
amq-protocol-1.8.0 lib/amq/bit_set.rb
amq-protocol-1.7.0 lib/amq/bit_set.rb
amq-protocol-1.6.0 lib/amq/bit_set.rb
amq-protocol-1.5.0 lib/amq/bit_set.rb
amq-protocol-1.4.0 lib/amq/bit_set.rb
amq-protocol-1.3.0 lib/amq/bit_set.rb
amq-protocol-1.2.0 lib/amq/bit_set.rb
amq-protocol-1.1.0 lib/amq/bit_set.rb
amq-protocol-1.0.1 lib/amq/bit_set.rb
amq-protocol-1.0.0 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre7 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre6 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre5 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre4 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre3 lib/amq/bit_set.rb
amq-protocol-1.0.0.pre2 lib/amq/bit_set.rb