decode_view::copy

Copy a decoded substring to another character string.

Synopsis

size_type
copy(
    char* dest,
    size_type count,
    size_type pos = 0) const;

Description

This function copies a substring to the character array pointed to by the destination char string, where rcount is the smaller of count and size() - pos.

Exception Safety

Strong guarantee. Exceptions thrown on invalid positions.

Preconditions

pos > size()

Exceptions

Type	Thrown On
`std::out_of_range`	`pos > size()`

Parameters

Name	Description
`dest`	pointer to the destination character string
`count`	requested substring length
`pos`	position of the first character

Return Value

Number of characters copied