Class: RASN1::Types::Enumerated

Inherits:
Integer show all
Defined in:
lib/rasn1/types/enumerated.rb

Overview

ASN.1 Enumerated

An ENUMERATED type permits to assign names to integer values. Integer may also be enumerated, but the tag ID is different.

A EnumeratedError is raised when set value is not in enumeration.

Examples:

Example 1

enum = RASN1::Types::Enumerated.new(enum: { 'a' => 0, 'b' => 1, 'c' => 2 })
enum.value = 'a'
enum.value       # => 'a'

Example 2

enum = RASN1::Types::Enumerated.new(enum: { a: 0, b: 1, c: 2 })
enum.value = :b
enum.value = 1   # equivalent to :b
# enum returned value is always symbolic (even if set with an integer)
enum.value       # => :b

Constant Summary collapse

ID =

Enumerated id value

0x0a

Constants inherited from Primitive

Primitive::ASN1_PC

Constants inherited from Base

Base::CLASSES, Base::CLASS_MASK, Base::INDEFINITE_LENGTH, Base::MULTI_OCTETS_ID

Instance Attribute Summary collapse

Attributes inherited from Base

#asn1_class, #default, #name, #options

Instance Method Summary collapse

Methods inherited from Integer

#der_to_value, #to_i, #value=, #void_value

Methods inherited from Base

#==, #can_build?, constrained?, #constructed?, #der_to_value, #do_parse, #do_parse_explicit, #do_parse_explicit_with_tracing, #do_parse_with_tracing, encoded_type, #explicit?, #id, #implicit?, #initialize_copy, #inspect, #optional?, parse, #parse!, #primitive?, #specific_initializer, start_tracing, stop_tracing, #tagged?, #to_der, #trace, #type, type, #value, #value=, #value?, #value_size, #void_value

Constructor Details

#initialize(options = {}) ⇒ Enumerated

Returns a new instance of Enumerated.

Parameters:

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :enum (Hash) —

    enumeration hash. Keys are names, and values are integers. This key is mandatory.

Raises:

See Also:



40
41
42
43
 
# File 'lib/rasn1/types/enumerated.rb', line 40

def initialize(options={})
  super
  raise EnumeratedError, 'no enumeration given' if @enum.empty?
end

Instance Attribute Details

#enum ⇒ Hash

Returns:

  • (Hash) 



# File 'lib/rasn1/types/enumerated.rb', line 29

Instance Method Details

#to_h ⇒ Hash

Returns:

  • (Hash) 


46
47
48
 
# File 'lib/rasn1/types/enumerated.rb', line 46

def to_h
  @enum
end