buffer.hpp

Go to the documentation of this file.

// Copyright (c) 2021 MIT Digital Currency Initiative,
//                    Federal Reserve Bank of Boston
// Distributed under the MIT software license, see the accompanying
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
 
#ifndef OPENCBDC_TX_SRC_COMMON_BUFFER_H_
#define OPENCBDC_TX_SRC_COMMON_BUFFER_H_
 
#include <optional>
#include <string>
#include <vector>
 
namespace cbdc {
    class buffer {
      public:
        buffer() = default;
 
        [[nodiscard]] auto size() const -> size_t;
 
        [[nodiscard]] auto data() -> void*;
 
        [[nodiscard]] auto data() const -> const void*;
 
        [[nodiscard]] auto data_at(size_t offset) -> void*;
 
        [[nodiscard]] auto data_at(size_t offset) const -> const void*;
 
        void append(const void* data, size_t len);
 
        void clear();
 
        auto operator==(const buffer& other) const -> bool;
 
        void extend(size_t len);
 
        [[nodiscard]] auto c_ptr() const -> const unsigned char*;
 
        [[nodiscard]] auto c_str() const -> const char*;
 
        static auto from_hex(const std::string& hex)
            -> std::optional<cbdc::buffer>;
 
        [[nodiscard]] auto to_hex() const -> std::string;
 
        static auto from_hex_prefixed(const std::string& hex,
                                      const std::string& prefix = "0x")
            -> std::optional<buffer>;
 
        [[nodiscard]] auto to_hex_prefixed(const std::string& prefix
                                           = "0x") const -> std::string;
 
      private:
        std::vector<std::byte> m_data{};
    };
}
 
#endif // OPENCBDC_TX_SRC_COMMON_BUFFER_H_