std::basic_string<CharT,Traits,Allocator>::copy

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

Копирует подстроку [pos, pos + count) в строку символов, указанную указателем dest. Если запрошенная подстрока выходит за конец строки, или если count == npos, копируемая подстрока [pos, size()).

Результирующая строка символов не завершается нулевым символом.

Параметры

Возвращаемое значение

Количество скопированных символов.

Исключения

std::out_of_range если pos > size ( ) .

Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).

Сложность

Линейно по count .

Пример

#include <iostream>
#include <string>
int main()
{
    std::string foo("WINE");
    // инициализация фигурными скобками инициализирует все символы нулями,
    // обеспечивая нуль-терминатор
    char bar[4]{};
    // не копировать последний символ, чтобы гарантировать нуль-терминацию
    foo.copy(bar, sizeof bar - 1);
    std::cout << bar << '\n'; // требует нуль-терминированной строки bar
}

WIN

Отчёты о дефектах

Следующие отчеты об изменениях в поведении, содержащие исправления дефектов, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также