asio::buffer_cast

The asio::buffer_cast function is used to obtain a pointer to the underlying memory region associated with a buffer. More...

Functions
template<typename PointerToPodType >
PointerToPodType	asio::buffer_cast (const mutable_buffer &b)
	Cast a non-modifiable buffer to a specified pointer to POD type. More...
template<typename PointerToPodType >
PointerToPodType	asio::buffer_cast (const const_buffer &b)
	Cast a non-modifiable buffer to a specified pointer to POD type. More...

Detailed Description

The asio::buffer_cast function is used to obtain a pointer to the underlying memory region associated with a buffer.

Examples:

To access the memory of a non-modifiable buffer, use:

 asio::const_buffer b1 = ...;
const unsigned char* p1 = asio::buffer_cast<const unsigned char*>(b1);

To access the memory of a modifiable buffer, use:

 asio::mutable_buffer b2 = ...;
unsigned char* p2 = asio::buffer_cast<unsigned char*>(b2);

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

Function Documentation

template<typename PointerToPodType >

PointerToPodType asio::buffer_cast ( const mutable_buffer &  b )

inline

Cast a non-modifiable buffer to a specified pointer to POD type.

Definition at line 424 of file buffer.hpp.

template<typename PointerToPodType >

PointerToPodType asio::buffer_cast ( const const_buffer &  b )

inline

Cast a non-modifiable buffer to a specified pointer to POD type.

Definition at line 431 of file buffer.hpp.