Botan::OctetString Class Reference

#include <symkey.h>

Public Member Functions
const uint8_t *	begin () const
secure_vector< uint8_t >	bits_of () const
const uint8_t *	end () const
size_t	length () const
	OctetString (const secure_vector< uint8_t > &in)
	OctetString (const std::string &str="")
	OctetString (const std::vector< uint8_t > &in)
	OctetString (const uint8_t in[], size_t len)
	OctetString (RandomNumberGenerator &rng, size_t len)
OctetString &	operator^= (const OctetString &other)
void	set_odd_parity ()
size_t	size () const
std::string	to_string () const

Detailed Description

Octet String

Definition at line 21 of file symkey.h.

Constructor & Destructor Documentation

OctetString() [1/5]

Botan::OctetString::OctetString ( const std::string &  str = "" )

explicit

Create a new OctetString

Parameters

str	is a hex encoded string

Definition at line 27 of file symkey.cpp.

   {
   if(!hex_string.empty())
      {
      m_data.resize(1 + hex_string.length() / 2);
      m_data.resize(hex_decode(m_data.data(), hex_string));
      }
   }

References Botan::hex_decode().

OctetString() [2/5]

Botan::OctetString::OctetString	(	RandomNumberGenerator &	rng,
		size_t	len
	)

Create a new random OctetString

Parameters

rng	is a random number generator
len	is the desired length in bytes

Definition at line 18 of file symkey.cpp.

   {
   rng.random_vec(m_data, len);
   }

References Botan::RandomNumberGenerator::random_vec().

OctetString() [3/5]

Botan::OctetString::OctetString	(	const uint8_t	in[],
		size_t	len
	)

Create a new OctetString

Parameters

in	is an array
len	is the length of in in bytes

Definition at line 39 of file symkey.cpp.

   {
   m_data.assign(in, in + n);
   }

OctetString() [4/5]

Botan::OctetString::OctetString ( const secure_vector< uint8_t > &  in )

inline

Create a new OctetString

Parameters

in	a bytestring

Definition at line 91 of file symkey.h.

: m_data(in) {}

OctetString() [5/5]

Botan::OctetString::OctetString ( const std::vector< uint8_t > &  in )

inline

Create a new OctetString

Parameters

in	a bytestring

Definition at line 97 of file symkey.h.

: m_data(in.begin(), in.end()) {}

Member Function Documentation

begin()

const uint8_t * Botan::OctetString::begin ( ) const

inline

Returns

start of this string

Definition at line 38 of file symkey.h.

{ return m_data.data(); }

Referenced by Botan::ECIES_KA_Operation::derive_secret(), Botan::operator^(), operator^=(), and Botan::SymmetricAlgorithm::set_key().

bits_of()

secure_vector< uint8_t > Botan::OctetString::bits_of ( ) const

inline

Returns

this object as a secure_vector<uint8_t>

Definition at line 33 of file symkey.h.

{ return m_data; }

Referenced by Botan::check_passhash9(), Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::generate_passhash9(), Botan::operator+(), Botan::operator==(), Botan::Cipher_Mode_Filter::set_iv(), Botan::TLS::Callbacks::tls_dh_agree(), and Botan::TLS::Callbacks::tls_ecdh_agree().

end()

const uint8_t * Botan::OctetString::end ( ) const

inline

Returns

end of this string

Definition at line 43 of file symkey.h.

{ return begin() + m_data.size(); }

Referenced by Botan::ECIES_KA_Operation::derive_secret().

length()

size_t Botan::OctetString::length ( ) const

inline

Returns

size of this octet string in bytes

Definition at line 27 of file symkey.h.

{ return m_data.size(); }

Referenced by Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::get_cipher(), Botan::operator^(), operator^=(), Botan::Keyed_Filter::set_iv(), and Botan::SymmetricAlgorithm::set_key().

operator^=()

OctetString & Botan::OctetString::operator^=

(

const OctetString &

other

)

XOR the contents of another octet string into this one

Parameters

other

octet string

Returns

reference to this

Definition at line 78 of file symkey.cpp.

   {
   if(&k == this) { zeroise(m_data); return (*this); }
   xor_buf(m_data.data(), k.begin(), std::min(length(), k.length()));
   return (*this);
   }

References begin(), length(), Botan::xor_buf(), and Botan::zeroise().

set_odd_parity()

void Botan::OctetString::set_odd_parity

(

)

Force to have odd parity

Deprecated. There is no reason to use this outside of interacting with some very old or weird system which requires DES and also which do not automatically ignore the parity bits.

Definition at line 61 of file symkey.cpp.

   {
   for(size_t j = 0; j != m_data.size(); ++j)
      m_data[j] = odd_parity_of(m_data[j]);
   }

size()

size_t Botan::OctetString::size ( ) const

inline

Definition at line 28 of file symkey.h.

{ return m_data.size(); }

Referenced by Botan::rfc3394_keyunwrap(), and Botan::rfc3394_keywrap().

to_string()

std::string Botan::OctetString::to_string

(

)

const

Returns

this encoded as hex

Definition at line 70 of file symkey.cpp.

   {
   return hex_encode(m_data.data(), m_data.size());
   }

References Botan::hex_encode().

---

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

• src/lib/base/symkey.h
• src/lib/base/symkey.cpp