buffer_copy (13 of 30 overloads)

Copies bytes from a source buffer to a target buffer sequence.

template<
    typename MutableBufferSequence>
std::size_t buffer_copy(
    const MutableBufferSequence & target,
    const mutable_buffer & source,
    typename enable_if< is_mutable_buffer_sequence< MutableBufferSequence >::value >::type *  = 0);

Parameters

target: A modifiable buffer sequence representing the memory regions to which the bytes will be copied.
source: A modifiable buffer representing the memory region from which the bytes will be copied. The contents of the source buffer will not be modified.

Return Value

The number of bytes copied.

Remarks

The number of bytes copied is the lesser of:

buffer_size(target)
buffer_size(source)

This function is implemented in terms of memcpy, and consequently it cannot be used to copy between overlapping memory regions.