| Home | Libraries | People | FAQ | More

### 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`