/* * OctetString * (C) 1999-2007 Jack Lloyd * * Distributed under the terms of the Botan license */ #ifndef BOTAN_SYMKEY_H__ #define BOTAN_SYMKEY_H__ #include #include namespace Botan { /** * Octet String */ class BOTAN_DLL OctetString { public: /** * @return size of this octet string in bytes */ size_t length() const { return bits.size(); } /** * @return this object as a secure_vector */ secure_vector bits_of() const { return bits; } /** * @return start of this string */ const byte* begin() const { return &bits[0]; } /** * @return end of this string */ const byte* end() const { return begin() + bits.size(); } /** * @return this encoded as hex */ std::string as_string() const; /** * XOR the contents of another octet string into this one * @param other octet string * @return reference to this */ OctetString& operator^=(const OctetString& other); /** * Force to have odd parity */ void set_odd_parity(); /** * Create a new OctetString * @param str is a hex encoded string */ OctetString(const std::string& str = ""); /** * Create a new random OctetString * @param rng is a random number generator * @param len is the desired length in bytes */ OctetString(class RandomNumberGenerator& rng, size_t len); /** * Create a new OctetString * @param in is an array * @param len is the length of in in bytes */ OctetString(const byte in[], size_t len); /** * Create a new OctetString * @param in a bytestring */ OctetString(const secure_vector& in) : bits(in) {} /** * Create a new OctetString * @param in a bytestring */ OctetString(const std::vector& in) : bits(in.begin(), in.end()) {} private: secure_vector bits; }; /** * Compare two strings * @param x an octet string * @param y an octet string * @return if x is equal to y */ BOTAN_DLL bool operator==(const OctetString& x, const OctetString& y); /** * Compare two strings * @param x an octet string * @param y an octet string * @return if x is not equal to y */ BOTAN_DLL bool operator!=(const OctetString& x, const OctetString& y); /** * Concatenate two strings * @param x an octet string * @param y an octet string * @return x concatenated with y */ BOTAN_DLL OctetString operator+(const OctetString& x, const OctetString& y); /** * XOR two strings * @param x an octet string * @param y an octet string * @return x XORed with y */ BOTAN_DLL OctetString operator^(const OctetString& x, const OctetString& y); /** * Alternate name for octet string showing intent to use as a key */ typedef OctetString SymmetricKey; /** * Alternate name for octet string showing intent to use as an IV */ typedef OctetString InitializationVector; } #endif