std::basic_string_view<CharT,Traits>::copy
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) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/string/basic_string_view/copy