|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
size_type copy( CharT* dest, size_type count, size_type pos=0)const; | (since C++17) (constexpr since C++20) | |
Copies the substring[pos, pos+ rcount) to the character array pointed to bydest, wherercount is the smaller ofcount andsize()- pos.
Equivalent toTraits::copy(dest, data()+ pos, rcount).
Contents |
| dest | - | pointer to the destination character string |
| count | - | requested substring length |
| pos | - | position of the first character |
Number of characters copied.
std::out_of_range ifpos> size().
Linear inrcount.
#include <array>#include <cstddef>#include <iostream>#include <stdexcept>#include <string_view> int main(){constexprstd::basic_string_view<char> source{"ABCDEF"};std::array<char,8> dest;std::size_t count{}, pos{}; dest.fill('\0'); source.copy(dest.data(), count=4);// pos = 0std::cout<< dest.data()<<'\n';// ABCD dest.fill('\0'); source.copy(dest.data(), count=4, pos=1);std::cout<< dest.data()<<'\n';// BCDE dest.fill('\0'); source.copy(dest.data(), count=42, pos=2);// ok, count -> 4std::cout<< dest.data()<<'\n';// CDEF try{ source.copy(dest.data(), count=1, pos=666);// throws: pos > size()}catch(std::out_of_rangeconst& ex){std::cout<< ex.what()<<'\n';}}
Output:
ABCDBCDECDEFbasic_string_view::copy: __pos (which is 666) > __size (which is 6)
| returns a substring (public member function)[edit] | |
| copies characters (public member function of std::basic_string<CharT,Traits,Allocator>)[edit] | |
(C++11) | copies a range of elements to a new location (function template)[edit] |
| copies one buffer to another (function)[edit] |
