Botan::BufferStuffer Class Reference

Helper class to ease in-place marshalling of concatenated fixed-length values. More...

#include <stl_util.h>

Public Member Functions
constexpr void	append (std::span< const uint8_t > buffer)
constexpr void	append (uint8_t b, size_t repeat=1)
constexpr	BufferStuffer (std::span< uint8_t > buffer)
constexpr bool	full () const
template<size_t bytes>
constexpr std::span< uint8_t, bytes >	next ()
constexpr std::span< uint8_t >	next (size_t bytes)
template<concepts::contiguous_strong_type StrongT>
StrongSpan< StrongT >	next (size_t bytes)
constexpr uint8_t &	next_byte ()
constexpr size_t	remaining_capacity () const

Detailed Description

Helper class to ease in-place marshalling of concatenated fixed-length values.

The size of the final buffer must be known from the start, reallocations are not performed.

Definition at line 200 of file stl_util.h.

Constructor & Destructor Documentation

BufferStuffer()

constexpr Botan::BufferStuffer::BufferStuffer ( std::span< uint8_t > buffer )

inlineconstexpr

Definition at line 202 of file stl_util.h.

: m_buffer(buffer) {}

Member Function Documentation

append() [1/2]

constexpr void Botan::BufferStuffer::append ( std::span< const uint8_t > buffer )

inlineconstexpr

Definition at line 235 of file stl_util.h.

                                                           {
         auto sink = next(buffer.size());
         std::copy(buffer.begin(), buffer.end(), sink.begin());
      }

References next().

Referenced by Botan::EME_PKCS1v15::pad(), and Botan::sign_message().

append() [2/2]

constexpr void Botan::BufferStuffer::append ( uint8_t b, size_t repeat = 1 )

inlineconstexpr

Definition at line 240 of file stl_util.h.

                                                          {
         auto sink = next(repeat);
         std::fill(sink.begin(), sink.end(), b);
      }

References next().

full()

constexpr bool Botan::BufferStuffer::full ( ) const

inlineconstexpr

Definition at line 245 of file stl_util.h.

{ return m_buffer.empty(); }

Referenced by Botan::fors_public_key_from_signature(), Botan::fors_sign_and_pkgen(), Botan::ht_sign(), Botan::EME_PKCS1v15::pad(), Botan::sign_message(), and Botan::Keccak_Permutation::squeeze().

next() [1/3]

template<size_t bytes>

constexpr std::span< uint8_t, bytes > Botan::BufferStuffer::next ( )

inlineconstexpr

Definition at line 217 of file stl_util.h.

                                               {
         BOTAN_STATE_CHECK(m_buffer.size() >= bytes);
 
         auto result = m_buffer.first<bytes>();
         m_buffer = m_buffer.subspan(bytes);
         return result;
      }

References BOTAN_STATE_CHECK.

Referenced by append(), append(), next(), and next_byte().

next() [2/3]

constexpr std::span< uint8_t > Botan::BufferStuffer::next ( size_t bytes )

inlineconstexpr

Returns

a span for the next bytes bytes in the concatenated buffer. Checks that the buffer is not exceded.

Definition at line 208 of file stl_util.h.

                                                    {
         BOTAN_STATE_CHECK(m_buffer.size() >= bytes);
 
         auto result = m_buffer.first(bytes);
         m_buffer = m_buffer.subspan(bytes);
         return result;
      }

References BOTAN_STATE_CHECK.

Referenced by Botan::create_aes_row_generator(), Botan::fors_public_key_from_signature(), Botan::fors_sign_and_pkgen(), Botan::ht_sign(), Botan::Keccak_Permutation::squeeze(), Botan::wots_public_key_from_signature(), Botan::wots_sign_and_pkgen(), and Botan::xmss_sign_and_pkgen().

next() [3/3]

template<concepts::contiguous_strong_type StrongT>

StrongSpan< StrongT > Botan::BufferStuffer::next ( size_t bytes )

inline

Definition at line 226 of file stl_util.h.

                                             {
         return StrongSpan<StrongT>(next(bytes));
      }

References next().

next_byte()

constexpr uint8_t & Botan::BufferStuffer::next_byte ( )

inlineconstexpr

Returns

a reference to the next single byte in the buffer

Definition at line 233 of file stl_util.h.

{ return next(1)[0]; }

References next().

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

remaining_capacity()

constexpr size_t Botan::BufferStuffer::remaining_capacity ( ) const

inlineconstexpr

Definition at line 247 of file stl_util.h.

{ return m_buffer.size(); }

Referenced by Botan::Keccak_Permutation::squeeze(), and Botan::xmss_sign_and_pkgen().

---

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

• src/lib/utils/stl_util.h