std::basic_string_view<CharT,Traits>::copy
< cpp | string | basic string view
size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const; |
(since C++17) (until C++20) |
|
constexpr size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const; |
(since C++20) | |
Copies the substring [pos, pos + rcount)
to the character array pointed to by dest
, where rcount
is the smaller of count
and size() - pos.
Equivalent to Traits::copy(dest, data() + pos, rcount).
Parameters
dest | - | pointer to the destination character string |
pos | - | position of the first character |
count | - | requested substring length |
Return value
Number of characters copied
Exceptions
std::out_of_range if pos > size().
Complexity
Linear in rcount
.
See also
returns a substring (public member function) |