Class: Cassandra::Long

### Home Classes Methods

### In Files

- lib/cassandra/long.rb

### Parent

Cassandra::Comparable

### Methods

- ::new
- #inspect
- #to_guid
- #to_i

### Files

- CHANGELOG
- LICENSE
- Makefile

### Class/Module Index

Quicksearch

- Cassandra
- Cassandra::Batch
- Cassandra::ColumnFamily
- Cassandra::Comparable
- Cassandra::Composite
- Cassandra::Consistency
- Cassandra::Constants
- Cassandra::DynamicComposite
- Cassandra::Helpers
- Cassandra::Keyspace
- Cassandra::Long
- Cassandra::Mock
- CassandraThrift
- CassandraThrift::Cassandra
- CassandraThrift::Cassandra::Client
- SimpleUUID
- SimpleUUID::UUID
- Array
- Time

No matching classes.

# Cassandra::Long

A temporally-ordered Long class for use in Cassandra column names

### Public Class Methods

new(bytes = nil) click to toggle source

FIXME Should unify with or subclass Cassandra::UUID

    # File lib/cassandra/long.rb, line 7
    def initialize(bytes = nil)
      case bytes
      when self.class # Long
        @bytes = bytes.to_s
      when String
        case bytes.size
        when 8 # Raw byte array
          @bytes = bytes
        when 18 # Human-readable UUID-like representation; inverse of #to_guid
          elements = bytes.split("-")
          raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (malformed UUID-like representation)" if elements.size != 3
          @bytes = [elements.join].pack('H32')
        else
          raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (invalid bytecount)"
        end
      when Integer
        raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (integer out of range)" if bytes < 0 or bytes > 2**64
        @bytes = [bytes >> 32, bytes % 2**32].pack("NN")
      when NilClass, Time
        # Time.stamp is 52 bytes, so we have 12 bytes of entropy left over
        int = ((bytes || Time).stamp << 12) + rand(2**12)
        @bytes = [int >> 32, int % 2**32].pack("NN")
      else
        raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (unknown source class)"
      end
    end

### Public Instance Methods

inspect() click to toggle source

    # File lib/cassandra/long.rb, line 46
    def inspect
      "<Cassandra::Long##{object_id} time: #{
        Time.at((to_i >> 12) / 1_000_000).utc.inspect
      }, usecs: #{
        (to_i >> 12) % 1_000_000
      }, jitter: #{
        to_i % 2**12
      }, guid: #{
        to_guid
      }>"
    end

to_guid() click to toggle source

    # File lib/cassandra/long.rb, line 42
    def to_guid
      "%08x-%04x-%04x" % @bytes.unpack("Nnn")
    end

to_i() click to toggle source

    # File lib/cassandra/long.rb, line 34
    def to_i
      @to_i ||= begin
        ints = @bytes.unpack("NN")
        (ints[0] << 32) +
        ints[1]
      end
    end

[Validate]

Generated with the Darkfish Rdoc Generator 2.