buffer_copy (21 of 30 overloads)

Copies a limited number of bytes from a source buffer to a target buffer.

std::size_t buffer_copy(
    const mutable_buffers_1 & target,
    const const_buffer & source,
    std::size_t max_bytes_to_copy);

target: A modifiable buffer representing the memory region to which the bytes will be copied.
source: A non-modifiable buffer representing the memory region from which the bytes will be copied.
max_bytes_to_copy: The maximum number of bytes to be copied.

The number of bytes copied.

The number of bytes copied is the lesser of:

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