Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext
string::copy

Copy a substring to another string.

Synopsis
std::size_t
copy(
    char* dest,
    std::size_t count,
    std::size_t pos = 0) const;
Description

Copies std::min(count, size() - pos) characters starting at index pos to the string pointed to by dest.

Remarks

The resulting string is not null terminated.

Return Value

The number of characters copied.

Parameters

Name

Description

count

The number of characters to copy.

dest

The string to copy to.

pos

The index to begin copying from. The default argument for this parameter is 0.

Exceptions

Type

Thrown On

boost::system::system_error

pos > max_size().


PrevUpHomeNext