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

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

constexpr 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++.

См. также