Sha256: a303ac7ca826faadb2e12b9c9f2fbab90c8707f4c2f38710caa6421314f644b7

Contents?: true

Size: 1.74 KB

Versions: 22

Compression:

Stored size: 1.74 KB

Contents

# encoding: utf-8

module AMQP
  # Very minimalistic, pure Ruby implementation of bit set. Inspired by java.util.BitSet,
  # although significantly smaller in scope.
  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 # AMQP

Version data entries

22 entries across 22 versions & 1 rubygems

Version Path
amqp-0.9.10 lib/amqp/bit_set.rb
amqp-0.9.9 lib/amqp/bit_set.rb
amqp-0.9.8 lib/amqp/bit_set.rb
amqp-0.9.7 lib/amqp/bit_set.rb
amqp-0.9.6 lib/amqp/bit_set.rb
amqp-1.0.0.pre1 lib/amqp/bit_set.rb
amqp-0.9.5 lib/amqp/bit_set.rb
amqp-0.9.4 lib/amqp/bit_set.rb
amqp-0.9.3 lib/amqp/bit_set.rb
amqp-0.9.2 lib/amqp/bit_set.rb
amqp-0.9.1 lib/amqp/bit_set.rb
amqp-0.9.0 lib/amqp/bit_set.rb
amqp-0.9.0.pre3 lib/amqp/bit_set.rb
amqp-0.9.0.pre2 lib/amqp/bit_set.rb
amqp-0.9.0.pre1 lib/amqp/bit_set.rb
amqp-0.8.4 lib/amqp/bit_set.rb
amqp-0.8.3 lib/amqp/bit_set.rb
amqp-0.8.2 lib/amqp/bit_set.rb
amqp-0.8.1 lib/amqp/bit_set.rb
amqp-0.8.0 lib/amqp/bit_set.rb