Contents

Bitwise
=======

Fast, memory efficient bitwise operations on large binary strings.

Internally a bit array is represented as a ruby string with `Encoding::ASCII_8BIT` encoding, which keeps billions of bits in a workable footprint.

* 1,000,000 bits = 125KB
* 10,000,000 bits = 1.25MB
* 100,000,000 bits = 12.5MB
* 1,000,000,000 bits = 125MB

Install
-------

    gem install bitwise

Usage
-----

Bitwise assignment and retrieval:

```ruby
b = Bitwise.new(1)

b.to_bits
 => "00000000"

b.set_at(1)
b.set_at(4)

b.to_bits
 => "01001000"

b.clear_at(1)

b.to_bits
 => "00001000"
```

Index assignment and retrieval:

```ruby
b = Bitwise.new
b.indexes = [1, 10, 100]

b.to_bits
 => "01000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000"

b.cardinality
 => 3

b.size
 => 13

b.set_at(20)

b.to_bits
 => "01000000001000000000100000000000000000000000000000000000000000000000000000000000000000000000000000001000"

b.value.unpack('C*')
 => [64, 32, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8]

b.cardinality
 => 4

b.indexes
 => [1, 10, 20, 100]
```

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
bitwise-0.1.2	README.md
bitwise-0.1.1	README.md
bitwise-0.1.0	README.md