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");
    
    // brace-initialization initializes all characters to 0,
    // providing a null-terminator
    char bar[4]{};
    
    // do not copy the last char, to guarantee null-termination
    foo.copy(bar, sizeof bar - 1);
    
    std::cout << bar << '\n'; // requires bar to be null-terminated
}

WIN

Отчёты об ошибках

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

См. также