| Home | Libraries | People | FAQ | More

#### buffer_copy (22 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_buffers_1 & source,
        std::size_t max_bytes_to_copy);

###### Parameters

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.

###### Return Value

The number of bytes copied.

###### Remarks

The number of bytes copied is the lesser of:

- `buffer_size(target)`
- `buffer_size(source)`
- `max_bytes_to_copy`

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