Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext

const_buffer

Holds a buffer that cannot be modified.

class const_buffer
Member Functions

Name

Description

const_buffer

Construct an empty buffer.

Construct a buffer to represent a given memory range.

Construct a non-modifiable buffer from a modifiable one.

Related Functions

Name

Description

operator+

Create a new non-modifiable buffer that is offset from the start of another.

The const_buffer class provides a safe representation of a buffer that cannot be modified. It does not own the underlying data, and so is cheap to copy or assign.

Accessing Buffer Contents

The contents of a buffer may be accessed using the buffer_size and buffer_cast functions:

boost::asio::const_buffer b1 = ...;
std::size_t s1 = boost::asio::buffer_size(b1);
const unsigned char* p1 = boost::asio::buffer_cast<const unsigned char*>(b1);

The boost::asio::buffer_cast function permits violations of type safety, so uses of it in application code should be carefully considered.

Requirements

Header: boost/asio/buffer.hpp

Convenience header: boost/asio.hpp


PrevUpHomeNext