std::basic_string::copy
From cppreference.com
                    
                                        
                    < cpp | string | basic string
                    
                                                            
                    |   size_type copy( CharT* dest,                 size_type count,  | 
||
Copies a substring [pos, pos+count) to character string pointed to by dest. If the requested substring lasts past the end of the string, or if count == npos, the copied substring is [pos, size()). The resulting character string is not null-terminated.
If pos >= size(), std::out_of_range is thrown.
Contents | 
[edit] Parameters
| dest | - | pointer to the destination character string | 
| pos | - | position of the first character to include | 
| count | - | length of the substring | 
[edit] Return value
number of characters copied
[edit] Exceptions
std::out_of_range if pos >= size().
[edit] Complexity
linear in count
[edit] Example
| This section is incomplete Reason: no example  | 
[edit] See also
|    returns a substring  (public member function)  | |