Module: Ruby::Enum::ClassMethods

Defined in:
lib/ruby-enum/enum.rb

Instance Method Summary collapse

Instance Method Details

#const_missing(key) ⇒ Object



29
30
31
32
33
34
35
# File 'lib/ruby-enum/enum.rb', line 29

def const_missing(key)
  if @_enum_hash[key]
    @_enum_hash[key].value
  else
    fail Ruby::Enum::Errors::UninitializedConstantError, name: name, key: key
  end
end

#define(key, value) ⇒ Object

Define an enumerated value.

Parameters

key

Enumerator key.

value

Enumerator value.



21
22
23
24
25
26
27
# File 'lib/ruby-enum/enum.rb', line 21

def define(key, value)
  @_enum_hash ||= {}
  @_enums_by_value ||= {}
  new_instance = new(key, value)
  @_enum_hash[key] = new_instance
  @_enums_by_value[value] = new_instance
end

#each(&block) ⇒ Object

Iterate over all enumerated values. Required for Enumerable mixin



39
40
41
# File 'lib/ruby-enum/enum.rb', line 39

def each(&block)
  @_enum_hash.each(&block)
end

#key(v) ⇒ Object

Gets the key symbol for the specified value.

Parameters

v

The string value to parse.

Returns the corresponding key symbol or nil.



95
96
97
98
# File 'lib/ruby-enum/enum.rb', line 95

def key(v)
  enum = @_enums_by_value[v]
  enum.key if enum
end

#key?(k) ⇒ Boolean

Whether the specified key exists in this enum.

Parameters

k

The string key to check.

Returns true if the key exists, false otherwise.

Returns:



64
65
66
# File 'lib/ruby-enum/enum.rb', line 64

def key?(k)
  @_enum_hash.key?(k)
end

#keysObject

Returns all enum keys.



101
102
103
# File 'lib/ruby-enum/enum.rb', line 101

def keys
  @_enum_hash.values.map(&:key)
end

#parse(k) ⇒ Object

Attempt to parse an enum key and return the corresponding value.

Parameters

k

The key string to parse.

Returns the corresponding value or nil.



50
51
52
53
54
55
56
# File 'lib/ruby-enum/enum.rb', line 50

def parse(k)
  k = k.to_s.upcase
  each do |key, enum|
    return enum.value if key.to_s.upcase == k
  end
  nil
end

#to_hObject



110
111
112
113
114
# File 'lib/ruby-enum/enum.rb', line 110

def to_h
  Hash[@_enum_hash.map do |key, enum|
    [key, enum.value]
  end]
end

#value(k) ⇒ Object

Gets the string value for the specified key.

Parameters

k

The key symbol to get the value for.

Returns the corresponding enum instance or nil.



74
75
76
77
# File 'lib/ruby-enum/enum.rb', line 74

def value(k)
  enum = @_enum_hash[k]
  enum.value if enum
end

#value?(v) ⇒ Boolean

Whether the specified value exists in this enum.

Parameters

k

The string value to check.

Returns true if the value exists, false otherwise.

Returns:



85
86
87
# File 'lib/ruby-enum/enum.rb', line 85

def value?(v)
  @_enums_by_value.key?(v)
end

#valuesObject

Returns all enum values.



106
107
108
# File 'lib/ruby-enum/enum.rb', line 106

def values
  @_enum_hash.values.map(&:value)
end