16 Buffers [buffer]

16.9 Function buffer_copy [buffer.copy]

template<class MutableBufferSequence, class ConstBufferSequence> size_t buffer_copy(const MutableBufferSequence& dest, const ConstBufferSequence& source) noexcept; template<class MutableBufferSequence, class ConstBufferSequence> size_t buffer_copy(const MutableBufferSequence& dest, const ConstBufferSequence& source, size_t max_size) noexcept;

1

Effects: Copies bytes from the buffer sequence source to the buffer sequence dest, as if by calls to memcpy.

2

The number of bytes copied is the lesser of:

  • (2.1)

    buffer_size(dest);

  • (2.2)

    buffer_size(source); and

  • (2.3)

    max_size, if specified.

3

The mutable buffer sequence dest specifies memory where the data should be placed. The operation always fills a buffer in the sequence completely before proceeding to the next.

4

The constant buffer sequence source specifies memory where the data to be written is located. The operation always copies a buffer in the sequence completely before proceeding to the next.

5

Returns: The number of bytes copied from source to dest.