Common#

class Buffer#

Buffer, use to encapsulate the continuous data type of any other data area into a unified data transfer connection; support for packaging objects in managed and unmanaged ways. Among them, packaging an object in a managed manner requires that the shared smart pointer of the wrapped object be passed in, Buffer will try to automatically deconstruct the data pointer when destructing; packaging in an unmanaged manner will not automatically destruct the data pointer, and requires the user to control the release of the data. packaging an object in a managed manner could be like this:

std::vector<int>* vec = new std::vector<int>(10);
Buffer buffer(vec->data(), vec->size(), std::shared_ptr(vec));
// Use the buffer
// No need to delete vec manually.

packaging in an unmanaged manner could be like below:

std::vector<int>* vec = new std::vector<int>(10);
Buffer buffer(vec->data(), vec->size());
// Use the buffer
delete vec; // delete to release vector

If resizer set, you can resize the buffer like below:

std::string my_str;
 my_str.resize(100);
 Buffer buffer_1(my_str.data(), my_str.size());

// buffer_1.resize(500); // May encounter an exception

Buffer buffer_2(my_str.data(),
                my_str.size(),
                {}, // unmanaged
                [&my_str](std::shared_ptr<void>, size_t size) {
                  my_str.resize(size);
                  return my_str.data();
                });
buffer_2.resize(500);
std::cout << buffer_2.size(); // 500

Public Types

enum Base64Type#

Base64 encoding formats.

Values:

enumerator kDefault = 0#

The default Base64 type.

This type uses the standard Base64 character set, which includes 64 characters: A-Z, a-z, 0-9, +, and /.

enumerator kUrlSafe = 1#

The URL-safe Base64 type.

This type uses a modified Base64 character set that is safe for use in URLs, which replaces + and / with - and _ respectively.

using Resizer = std::function<void*(std::shared_ptr<void>, size_t)>#: Buffer resizer function type.

Public Functions

explicit Buffer(size_t size = 0)#

Construct a new buffer with given data, default size is 0, which means the buffer is empty.

Parameters:: size – buffer size.

Buffer(void *data, size_t size, std::shared_ptr<void> owner = {}, Resizer resizer = {})#

Construct a new Buffer object with given data pointer and size.

Parameters:

data – data pointer.
size – data size.
owner – whether the data pointer is managed by this buffer. If owner shared_pointer is not empty, the data pointer will be deleted when this buffer is destructed.
resizer – resizer function, if resizer is not empty, the buffer will be resized when the buffer size is changed. otherwise, the buffer will be a fixed size buffer and can not be resized.

Buffer(const Buffer &other) = default#

Copy constructor, only copy the data pointer and size, not the data. If you want to copy the data, you should use Buffer::clone_data().

Parameters:: other – other buffer.

Buffer &operator=(const Buffer &other) = default#

Assign operator, only copy the data pointer and size, not the data. If you want to copy the data, you should use Buffer::clone_data().

Parameters:: other – other buffer.

Buffer(Buffer &&rvalue) noexcept = default#

Move constructor.

Parameters:: rvalue – other rvalue buffer.

bool operator==(const Buffer &other) const#

Check whether the buffer data is equal to the given buffer.

Parameters:: other – other buffer.
Returns:: true if the buffer data is equal to the given buffer.
Returns:: false if the buffer data is not equal to the given buffer.

void *resize(size_t size)#

Resize the buffer with given size.

Exception will be thrown if the buffer is not resizable, so you’d better to check the buffer is resizable before resize by call Buffer::is_resizable().

Parameters:: size – new size.
Throws:: excepts::LogicError – if the buffer is not resizable.
Returns:: void* new data pointer.

void append(const void *data, size_t size)#

Append the given data at the end of the buffer.

Parameters:

data – data pointer.
size – data size.

Throws:

excepts::LogicError – if append data out of the buffer reserved size and the buffer is not resizable.

void *reserve(size_t size)#

Reserve the buffer with given size.

Parameters:: size – new size.
Returns:: void* new data pointer.

void *data()#

Get the data pointer.

Returns:: void* data pointer.

const void *data() const#

Get the const data pointer.

Returns:: void const* const data pointer.

Buffer &from_file(const std::string &path)#

Read buffer content from the given file path.