123456789_123456789_123456789_123456789_123456789_

Class: OpenSSL::ASN1::Constructive

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ASN1Data
Instance Chain:
self, Enumerable, TaggedASN1Data, ASN1Data
Inherits: OpenSSL::ASN1::ASN1Data
Defined in: ext/openssl/ossl_asn1.c,
ext/openssl/lib/openssl/asn1.rb

Overview

The parent class for all constructed encodings. The value attribute of a Constructive is always an Array. Attributes are the same as for ASN1Data, with the addition of tagging.

SET and SEQUENCE

Most constructed encodings come in the form of a SET or a SEQUENCE. These encodings are represented by one of the two sub-classes of Constructive:

  • OpenSSL::ASN1::Set

  • OpenSSL::ASN1::Sequence

Please note that tagged sequences and sets are still parsed as instances of ASN1Data. Find further details on tagged values there.

Example - constructing a SEQUENCE

int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
sequence = OpenSSL::ASN1::Sequence.new( [ int, str ] )

Example - constructing a SET

int = OpenSSL::ASN1::Integer.new(1)
str = OpenSSL::ASN1::PrintableString.new('abc')
set = OpenSSL::ASN1::Set.new( [ int, str ] )

Class Method Summary

ASN1Data - Inherited

.new

value: Please have a look at Constructive and Primitive to see how Ruby types are mapped to ASN.1 types and vice versa.

Instance Attribute Summary

TaggedASN1Data - Included

#tagging

May be used as a hint for encoding a value either implicitly or explicitly by setting it either to :IMPLICIT or to :EXPLICIT.

ASN1Data - Inherited

#indefinite_length

Never nil.
#infinite_length

Alias for ASN1Data#indefinite_length.
#tag

An Integer representing the tag number of this ASN1Data.
#tag_class

A Symbol representing the tag class of this ASN1Data.
#value

Carries the value of a ASN.1 type.

Instance Method Summary

TaggedASN1Data - Included

#initialize

value: is mandatory.

ASN1Data - Inherited

#to_der

Encodes this ASN1Data into a DER-encoded String value.

Constructor Details

This class inherits a constructor from OpenSSL::ASN1::ASN1Data

Instance Method Details

#each {|asn1| ... } ⇒ 1

Calls the given block once for each element in self, passing that element as parameter asn1. If no block is given, an enumerator is returned instead.

Example

asn1_ary.each do |asn1|
  puts asn1
end
[ GitHub ] 

  


# File 'ext/openssl/lib/openssl/asn1.rb', line 148



def each(&blk)
  @value.each(&blk)

  self
end


  








  

    #to_der  ⇒ DER-encoded String   



  

    

See ASN1Data#to_der for details.


  



  [ GitHub ]


  

  


# File 'ext/openssl/ossl_asn1.c', line 1074



static VALUE
ossl_asn1cons_to_der(VALUE self)
{
    VALUE ary, str;
    long i;
    int indef_len;

    indef_len = RTEST(ossl_asn1_get_indefinite_length(self));
    ary = rb_convert_type(ossl_asn1_get_value(self), T_ARRAY, "Array", "to_a");
    str = rb_str_new(NULL, 0);
    for (i = 0; i < RARRAY_LEN(ary); i++) {
	VALUE item = RARRAY_AREF(ary, i);

	if (indef_len && rb_obj_is_kind_of(item, cASN1EndOfContent)) {
	    if (i != RARRAY_LEN(ary) - 1)
		ossl_raise(eASN1Error, "illegal EOC octets in value");

	    /*
	     * EOC is not really part of the content, but we required to add one
	     * at the end in the past.
	     */
	    break;
	}

	item = ossl_to_der_if_possible(item);
	StringValue(item);
	rb_str_append(str, item);
    }

    return to_der_internal(self, 1, indef_len, str);
}