Botan::BufferSlicer Class Reference

#include <stl_util.h>

Public Member Functions
	BufferSlicer (std::span< const uint8_t > buffer)
template<concepts::contiguous_container ContainerT>
auto	copy (const size_t count)
auto	copy_as_secure_vector (const size_t count)
auto	copy_as_vector (const size_t count)
void	copy_into (std::span< uint8_t > sink)
bool	empty () const
size_t	remaining () const
void	skip (const size_t count)
template<size_t count>
std::span< const uint8_t, count >	take ()
std::span< const uint8_t >	take (const size_t count)
template<concepts::contiguous_strong_type T>
StrongSpan< const T >	take (const size_t count)
uint8_t	take_byte ()

Detailed Description

Helper class to ease unmarshalling of concatenated fixed-length values

Definition at line 142 of file stl_util.h.

Constructor & Destructor Documentation

BufferSlicer()

Botan::BufferSlicer::BufferSlicer ( std::span< const uint8_t > buffer )

inline

Definition at line 144 of file stl_util.h.

: m_remaining(buffer) {}

Member Function Documentation

copy()

template<concepts::contiguous_container ContainerT>

auto Botan::BufferSlicer::copy ( const size_t count )

inline

Definition at line 147 of file stl_util.h.

                                    {
         const auto result = take(count);
         return ContainerT(result.begin(), result.end());
      }

References take().

Referenced by Botan::FrodoKEM_PrivateKey::FrodoKEM_PrivateKey(), Botan::FrodoKEM_PublicKey::FrodoKEM_PublicKey(), and Botan::Sphincs_Hash_Functions::H_msg().

copy_as_secure_vector()

auto Botan::BufferSlicer::copy_as_secure_vector ( const size_t count )

inline

Definition at line 154 of file stl_util.h.

{ return copy<secure_vector<uint8_t>>(count); }

Referenced by Botan::TLS::Session::decrypt(), Botan::Kyber_PrivateKey::Kyber_PrivateKey(), and Botan::XMSS_PublicKey::XMSS_PublicKey().

copy_as_vector()

auto Botan::BufferSlicer::copy_as_vector ( const size_t count )

inline

Definition at line 152 of file stl_util.h.

{ return copy<std::vector<uint8_t>>(count); }

Referenced by Botan::Kyber_PublicKey::initialize_from_encoding(), and Botan::Kyber_PrivateKey::Kyber_PrivateKey().

copy_into()

void Botan::BufferSlicer::copy_into ( std::span< uint8_t > sink )

inline

Definition at line 178 of file stl_util.h.

                                            {
         const auto data = take(sink.size());
         std::copy(data.begin(), data.end(), sink.begin());
      }

References take().

empty()

bool Botan::BufferSlicer::empty ( ) const

inline

Definition at line 187 of file stl_util.h.

{ return m_remaining.empty(); }

Referenced by Botan::Keccak_Permutation::absorb(), Botan::BLAKE2b::add_data(), Botan::Streebog::add_data(), Botan::MD4::compress_n(), Botan::compute_root(), Botan::FrodoKEM_PrivateKey::FrodoKEM_PrivateKey(), Botan::FrodoKEM_PublicKey::FrodoKEM_PublicKey(), Botan::Sphincs_Hash_Functions::H_msg(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::handle_unaligned_data(), Botan::ht_verify(), Botan::Kyber_PublicKey::initialize_from_encoding(), Botan::Kyber_PrivateKey::Kyber_PrivateKey(), Botan::Kyber_PrivateKey::Kyber_PrivateKey(), Botan::TLS::Hybrid_KEM_PublicKey::load_for_group(), and Botan::MerkleDamgard_Hash< MD >::update().

remaining()

size_t Botan::BufferSlicer::remaining ( ) const

inline

Definition at line 185 of file stl_util.h.

{ return m_remaining.size(); }

Referenced by Botan::Keccak_Permutation::absorb(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::aligned_data_to_process(), Botan::TLS::Session::decrypt(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::handle_unaligned_data(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::next_aligned_block_to_process(), take(), and take().

skip()

void Botan::BufferSlicer::skip ( const size_t count )

inline

Definition at line 183 of file stl_util.h.

{ take(count); }

References take().

Referenced by Botan::Kyber_PrivateKey::Kyber_PrivateKey(), and Botan::XMSS_PublicKey::XMSS_PublicKey().

take() [1/3]

template<size_t count>

std::span< const uint8_t, count > Botan::BufferSlicer::take ( )

inline

Definition at line 164 of file stl_util.h.

                                           {
         BOTAN_STATE_CHECK(remaining() >= count);
         auto result = m_remaining.first<count>();
         m_remaining = m_remaining.subspan(count);
         return result;
      }

References BOTAN_STATE_CHECK, and remaining().

Referenced by copy(), copy_into(), skip(), take(), and take_byte().

take() [2/3]

std::span< const uint8_t > Botan::BufferSlicer::take ( const size_t count )

inline

Definition at line 156 of file stl_util.h.

                                                      {
         BOTAN_STATE_CHECK(remaining() >= count);
         auto result = m_remaining.first(count);
         m_remaining = m_remaining.subspan(count);
         return result;
      }

References BOTAN_STATE_CHECK, and remaining().

Referenced by Botan::Keccak_Permutation::absorb(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::aligned_data_to_process(), Botan::SHA_256::compress_digest(), Botan::SHA_512::compress_digest(), Botan::SHA_512::compress_digest_bmi2(), Botan::SHA_256::compress_digest_x86_bmi2(), Botan::MD4::compress_n(), Botan::MD5::compress_n(), Botan::RIPEMD_160::compress_n(), Botan::SHA_1::compress_n(), Botan::SM3::compress_n(), Botan::Whirlpool::compress_n(), Botan::compute_root(), Botan::TLS::Session::decrypt(), Botan::fors_public_key_from_signature(), Botan::FrodoKEM_PrivateKey::FrodoKEM_PrivateKey(), Botan::FrodoKEM_PublicKey::FrodoKEM_PublicKey(), Botan::Sphincs_Hash_Functions::H_msg(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::handle_unaligned_data(), Botan::ht_verify(), Botan::Kyber_PublicKey::initialize_from_encoding(), Botan::Kyber_PrivateKey::Kyber_PrivateKey(), Botan::Kyber_PrivateKey::Kyber_PrivateKey(), Botan::TLS::Hybrid_KEM_PublicKey::load_for_group(), Botan::AlignmentBuffer< T, BLOCK_SIZE, FINAL_BLOCK_STRATEGY >::next_aligned_block_to_process(), and Botan::wots_public_key_from_signature().

take() [3/3]

template<concepts::contiguous_strong_type T>

StrongSpan< const T > Botan::BufferSlicer::take ( const size_t count )

inline

Definition at line 172 of file stl_util.h.

                                                   {
         return StrongSpan<const T>(take(count));
      }

References take().

take_byte()

uint8_t Botan::BufferSlicer::take_byte ( )

inline

Definition at line 176 of file stl_util.h.

{ return take(1)[0]; }

References take().

Referenced by Botan::Keccak_Permutation::absorb().

---

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

• src/lib/utils/stl_util.h