Class: ClickhouseRuby::Types::Integer

Inherits:
Base
  • Object
show all
Defined in:
lib/clickhouse_ruby/types/integer.rb

Overview

Type handler for ClickHouse integer types

Handles: Int8, Int16, Int32, Int64, Int128, Int256

UInt8, UInt16, UInt32, UInt64, UInt128, UInt256

ClickHouse integers are exact - no floating point issues. Large integers (128, 256 bit) use Ruby’s BigInteger.

Constant Summary collapse

LIMITS =

Size limits for each integer type

{
  "Int8" => { min: -128, max: 127 },
  "Int16" => { min: -32_768, max: 32_767 },
  "Int32" => { min: -2_147_483_648, max: 2_147_483_647 },
  "Int64" => { min: -9_223_372_036_854_775_808, max: 9_223_372_036_854_775_807 },
  "Int128" => { min: -(2**127), max: (2**127) - 1 },
  "Int256" => { min: -(2**255), max: (2**255) - 1 },
  "UInt8" => { min: 0, max: 255 },
  "UInt16" => { min: 0, max: 65_535 },
  "UInt32" => { min: 0, max: 4_294_967_295 },
  "UInt64" => { min: 0, max: 18_446_744_073_709_551_615 },
  "UInt128" => { min: 0, max: (2**128) - 1 },
  "UInt256" => { min: 0, max: (2**256) - 1 },
}.freeze

Instance Attribute Summary

Attributes inherited from Base

#name

Instance Method Summary collapse

Methods inherited from Base

#==, #hash, #initialize, #nullable?, #to_s

Constructor Details

This class inherits a constructor from ClickhouseRuby::Types::Base

Instance Method Details

#bit_size ⇒ Integer

Returns the bit size of this integer type

Returns:

  • (Integer) —

    the bit size (8, 16, 32, 64, 128, or 256)



98
99
100
 
# File 'lib/clickhouse_ruby/types/integer.rb', line 98

def bit_size
  name.gsub(/[^0-9]/, "").to_i
end

#cast(value) ⇒ Integer?

Converts a Ruby value to an integer

Parameters:

  • value (Object) —

    the value to convert

Returns:

  • (Integer, nil) —

    the integer value

Raises:



35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/clickhouse_ruby/types/integer.rb', line 35

def cast(value)
  return nil if value.nil?

  case value
  when ::Integer
    validate_range!(value)
    value
  when ::Float
    int_value = value.to_i
    validate_range!(int_value)
    int_value
  when ::String
    int_value = parse_string(value)
    validate_range!(int_value)
    int_value
  when true
    1
  when false
    0
  else
    raise_cast_error(value)
  end
end

#deserialize(value) ⇒ Integer?

Converts a value from ClickHouse to Ruby Integer

Parameters:

  • value (Object) —

    the value from ClickHouse

Returns:

  • (Integer, nil) —

    the integer value



63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/clickhouse_ruby/types/integer.rb', line 63

def deserialize(value)
  return nil if value.nil?

  case value
  when ::Integer
    value
  when ::String
    parse_string(value)
  when ::Float
    value.to_i
  else
    value.to_i
  end
end

#serialize(value) ⇒ String

Converts an integer to SQL literal

Parameters:

  • value (Integer, nil) —

    the value to serialize

Returns:

  • (String) —

    the SQL literal



82
83
84
85
86
 
# File 'lib/clickhouse_ruby/types/integer.rb', line 82

def serialize(value)
  return "NULL" if value.nil?

  value.to_s
end

#unsigned? ⇒ Boolean

Returns whether this is an unsigned integer type

Returns:



91
92
93
 
# File 'lib/clickhouse_ruby/types/integer.rb', line 91

def unsigned?
  name.start_with?("U")
end