Botan::ASN1_String Class Reference

#include <asn1_obj.h>

Inheritance diagram for Botan::ASN1_String:

Public Member Functions
	ASN1_String (const std::string &utf8, ASN1_Tag tag)
	ASN1_String (const std::string &utf8="")
std::vector< uint8_t >	BER_encode () const
void	decode_from (class BER_Decoder &) override
bool	empty () const
void	encode_into (class DER_Encoder &) const override
std::string	iso_8859 () const
bool	operator== (const ASN1_String &other) const
size_t	size () const
ASN1_Tag	tagging () const
const std::string &	value () const

Static Public Member Functions
static bool	is_string_type (ASN1_Tag tag)

Detailed Description

ASN.1 string type This class normalizes all inputs to a UTF-8 std::string

Definition at line 392 of file asn1_obj.h.

Constructor & Destructor Documentation

ASN1_String() [1/2]

Botan::ASN1_String::ASN1_String ( const std::string &  utf8 = "" )

explicit

Definition at line 97 of file asn1_str.cpp.

                                             :
   m_utf8_str(str),
   m_tag(choose_encoding(m_utf8_str))
   {}

ASN1_String() [2/2]

Botan::ASN1_String::ASN1_String	(	const std::string &	utf8,
		ASN1_Tag	tag
	)

Definition at line 84 of file asn1_str.cpp.

                                                         : m_utf8_str(str), m_tag(t)
   {
   if(m_tag == DIRECTORY_STRING)
      {
      m_tag = choose_encoding(m_utf8_str);
      }
 
   assert_is_string_type(m_tag);
   }

References Botan::DIRECTORY_STRING.

Member Function Documentation

BER_encode()

std::vector< uint8_t > Botan::ASN1_Object::BER_encode ( ) const

inherited

Return the encoding of this object. This is a convenience method when just one object needs to be serialized. Use DER_Encoder for complicated encodings.

Definition at line 16 of file asn1_obj.cpp.

   {
   std::vector<uint8_t> output;
   DER_Encoder der(output);
   this->encode_into(der);
   return output;
   }

References Botan::ASN1_Object::encode_into().

Referenced by Botan::PSSR::config_for_x509(), Botan::Certificate_Store_In_SQL::find_all_certs(), Botan::Certificate_Store_In_SQL::find_cert(), Botan::X509_Certificate::fingerprint(), Botan::Certificate_Store_In_SQL::insert_cert(), Botan::X509_Object::PEM_encode(), and Botan::Certificate_Store_In_SQL::revoke_cert().

decode_from()

void Botan::ASN1_String::decode_from ( class BER_Decoder &  from )

overridevirtual

Decode whatever this object is from from

Parameters

from	the BER_Decoder that will be read from

Implements Botan::ASN1_Object.

Definition at line 129 of file asn1_str.cpp.

   {
   BER_Object obj = source.get_next_object();
 
   assert_is_string_type(obj.type());
 
   m_tag = obj.type();
   m_data.assign(obj.bits(), obj.bits() + obj.length());
 
   if(m_tag == BMP_STRING)
      {
      m_utf8_str = ucs2_to_utf8(m_data.data(), m_data.size());
      }
   else if(m_tag == UNIVERSAL_STRING)
      {
      m_utf8_str = ucs4_to_utf8(m_data.data(), m_data.size());
      }
   else
      {
      // All other supported string types are UTF-8 or some subset thereof
      m_utf8_str = ASN1::to_string(obj);
      }
   }

References Botan::BER_Object::bits(), Botan::BMP_STRING, Botan::BER_Decoder::get_next_object(), Botan::BER_Object::length(), Botan::ASN1::to_string(), Botan::BER_Object::type(), Botan::ucs2_to_utf8(), Botan::ucs4_to_utf8(), and Botan::UNIVERSAL_STRING.

empty()

bool Botan::ASN1_String::empty ( ) const

inline

Definition at line 404 of file asn1_obj.h.

{ return m_utf8_str.empty(); }

Referenced by Botan::X509_DN::add_attribute().

encode_into()

void Botan::ASN1_String::encode_into ( class DER_Encoder &  to ) const

overridevirtual

Encode whatever this object is into to

Parameters

to	the DER_Encoder that will be written to

Implements Botan::ASN1_Object.

Definition at line 113 of file asn1_str.cpp.

   {
   if(m_data.empty())
      {
      encoder.add_object(tagging(), UNIVERSAL, m_utf8_str);
      }
   else
      {
      // If this string was decoded, reserialize using original encoding
      encoder.add_object(tagging(), UNIVERSAL, m_data.data(), m_data.size());
      }
   }

References Botan::DER_Encoder::add_object(), tagging(), and Botan::UNIVERSAL.

is_string_type()

bool Botan::ASN1_String::is_string_type ( ASN1_Tag  tag )

static

Return true iff this is a tag for a known string type we can handle. This ignores string types that are not supported, eg teletexString

Definition at line 68 of file asn1_str.cpp.

   {
   return (tag == NUMERIC_STRING ||
           tag == PRINTABLE_STRING ||
           tag == VISIBLE_STRING ||
           tag == T61_STRING ||
           tag == IA5_STRING ||
           tag == UTF8_STRING ||
           tag == BMP_STRING ||
           tag == UNIVERSAL_STRING);
   }

References Botan::BMP_STRING, Botan::IA5_STRING, Botan::NUMERIC_STRING, Botan::PRINTABLE_STRING, Botan::T61_STRING, Botan::UNIVERSAL_STRING, Botan::UTF8_STRING, and Botan::VISIBLE_STRING.

Referenced by Botan::AlternativeName::decode_from().

iso_8859()

std::string Botan::ASN1_String::iso_8859

(

)

const

Definition at line 105 of file asn1_str.cpp.

   {
   return utf8_to_latin1(m_utf8_str);
   }

References Botan::utf8_to_latin1().

operator==()

bool Botan::ASN1_String::operator== ( const ASN1_String &  other ) const

inline

Definition at line 415 of file asn1_obj.h.

         { return value() == other.value(); }

size()

size_t Botan::ASN1_String::size ( ) const

inline

Definition at line 402 of file asn1_obj.h.

{ return value().size(); }

tagging()

ASN1_Tag Botan::ASN1_String::tagging ( ) const

inline

Definition at line 398 of file asn1_obj.h.

{ return m_tag; }

Referenced by encode_into().

value()

const std::string & Botan::ASN1_String::value ( ) const

inline

Definition at line 400 of file asn1_obj.h.

{ return m_utf8_str; }

Referenced by Botan::X509_DN::get_first_attribute(), and Botan::TLS::Session::Session().

---

The documentation for this class was generated from the following files:

• src/lib/asn1/asn1_obj.h
• src/lib/asn1/asn1_str.cpp