bsl::basic_string<char32_t>::copy

Copy from this string, starting from the optionally specified position, the specified numChars or length() - position characters, whichever is smaller, into the specified characterString buffer, and return the number of characters copied. If position is not specified, 0 is used. Throw out_of_range if position > length(). The behavior is undefined unless characterString is at least numChars long. Note that the output characterString is not null-terminated.

Synopsis

Declared in <bslstl_string.h>

size_type
copy(
    char32_t* characterString,
    size_type numChars,
    size_type position = 0) const;