std::basic_string::copy

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Strings library
Narrow character strings Wide character strings Classes basic_string char_traits
std::basic_string
Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str Iterators basic_string::begin basic_string::cbegin (C++11) basic_string::end basic_string::cend (C++11) basic_string::rbegin basic_string::crbegin (C++11) basic_string::rend basic_string::crend (C++11) Capacity basic_string::empty basic_string::size basic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11) Operations basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constants basic_string::npos Non-member functions getline stoi stol stoll (C++11) (C++11) (C++11) stoul stoull (C++11) (C++11) stof stod stold (C++11) (C++11) (C++11) to_string (C++11) to_wstring (C++11)

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

Copies a substring [pos, pos+count) to character string pointed to by s. 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 1 Parameters 2 Return value 3 Exceptions 4 Complexity 5 Example 6 See also

[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

[edit] See also

substr	returns a substring (public member function)