Class BufferBlock

src/ipc/message_exchange.h:146–166

* @brief Message block that references an external buffer without owning it. * * @warning Lifetime Requirements: * - The buffer pointed to by `buffer_span` MUST remain valid for the entire * lifetime of this BufferBlock object. * - The buffer MUST NOT be deallocated or modified while this BufferBlock * exists. * - Typically, BufferBlock is used immediately in MessageComposer::

 *       bounds checking capabilities and does not own the buffer data.
 */
struct BufferBlock final : MessageBlock {
    /**
     * @brief Construct a BufferBlock from a std::span.
     *
     * @param span Span over the buffer data (the span's underlying buffer must
     *             remain valid for the lifetime of this BufferBlock)
     */
    explicit BufferBlock(std::span<const std::byte> span)
        : buffer_span_{span} {}

    [[nodiscard]] std::size_t size() const noexcept override {
        return buffer_span_.size();
    }

    [[nodiscard]] const std::byte* data() const noexcept override {
        return buffer_span_.data();
    }

  private:
    std::span<const std::byte> buffer_span_{};
};

class MessageComposer {
  public: