Class: RASN1::Types::Sequence

Inherits:
Constructed show all
Defined in:
lib/rasn1/types/sequence.rb,
lib/rasn1/tracer.rb

Overview

ASN.1 sequence

A sequence is a collection of another ASN.1 types.

To encode this ASN.1 example:

Record ::= SEQUENCE {
  id        INTEGER,
  room  [0] INTEGER OPTIONAL,
  house [1] IMPLICIT INTEGER DEFAULT 0
}

do:

seq = RASN1::Types::Sequence.new
seq.value = [
             RASN1::Types::Integer.new
             RASN1::Types::Integer.new(explicit: 0, optional: true),
             RASN1::Types::Integer.new(implicit: 1, default: 0)
            ]

A sequence may also be used without value to not parse sequence content:

seq = RASN1::Types::Sequence.new(:seq)
seq.parse!(der_string)
seq.value    # => String

Author:

  • Sylvain Daubert

Direct Known Subclasses

Set

Constant Summary collapse

ID =

Sequence id value

0x10

Constants inherited from Constructed

Constructed::ASN1_PC

Constants inherited from Base

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

Instance Attribute Summary

Attributes inherited from Base

#asn1_class, #default, #name, #options

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Constructed

#can_build?, #inspect

Methods inherited from Base

#==, #can_build?, constrained?, #constructed?, #do_parse_explicit_with_tracing, #do_parse_with_tracing, encoded_type, #explicit?, #id, #implicit?, #inspect, #optional?, parse, #parse!, #primitive?, #specific_initializer, #tagged?, #to_der, #trace, type, #type, #value, #value=, #value?, #value_size

Constructor Details

#initialize(options = {}) ⇒ Sequence

Returns a new instance of Sequence.

See Also:



33
34
35
36
37
 
# File 'lib/rasn1/types/sequence.rb', line 33

def initialize(options={})
  super
  @no_value = false
  @value ||= []
end

Class Method Details

.start_tracing ⇒ Object

Patch #der_to_value to add tracing ability



128
129
130
131
 
# File 'lib/rasn1/tracer.rb', line 128

def start_tracing
  alias_method :der_to_value_without_tracing, :der_to_value
  alias_method :der_to_value, :der_to_value_with_tracing
end

.stop_tracing ⇒ Object

Unpatch #der_to_value! to remove tracing ability



135
136
137
 
# File 'lib/rasn1/tracer.rb', line 135

def stop_tracing
  alias_method :der_to_value, :der_to_value_without_tracing
end

Instance Method Details

#[](idx_or_name) ⇒ Object?

Get element at index idx, or element of name name

Parameters:

  • idx_or_name (Integer, String, Symbol)

Returns:

  • (Object, nil) 


58
59
60
61
62
63
64
65
66
67
 
# File 'lib/rasn1/types/sequence.rb', line 58

def [](idx_or_name)
  return unless @value.is_a?(Array)

  case idx_or_name
  when ::Integer
    @value[idx_or_name.to_i]
  when String, Symbol
    @value.find { |elt| elt.name == idx_or_name }
  end
end

#der_to_value_with_tracing(der, ber: false) ⇒ Object

der_to_value der with tracing abillity



142
143
144
145
146
 
# File 'lib/rasn1/tracer.rb', line 142

def der_to_value_with_tracing(der, ber: false)
  RASN1.tracer.tracing_level += 1
  der_to_value_without_tracing(der, ber: ber)
  RASN1.tracer.tracing_level -= 1
end

#initialize_copy ⇒ Object

Deep copy @value



40
41
42
43
44
45
46
47
48
 
# File 'lib/rasn1/types/sequence.rb', line 40

def initialize_copy(*)
  super
  @value = case @value
           when Array
             @value.map(&:dup)
           else
             @value.dup
           end
end

#void_value ⇒ Array

Returns:

  • (Array) 


51
52
53
 
# File 'lib/rasn1/types/sequence.rb', line 51

def void_value
  []
end