std::basic_string_view<CharT,Traits>::copy

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

(начиная с C++17)
(constexpr начиная с C++20)

Копирует подстроку [pos, pos + rcount) в массив символов, на который указывает dest, где rcount — меньшее из count и size() - pos.

Эквивалентно Traits::copy(dest, data() + pos, rcount).

Параметры

dest	-	указатель на целевую строку символов
count	-	запрошенная длина подстроки
pos	-	позиция первого символа

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

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

Исключения

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

Сложность

Линейная относительно rcount.

Пример

#include <array>
#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string_view>

int main()
{
    constexpr std::basic_string_view<char> source{"ABCDEF"};
    std::array<char, 8> dest;
    std::size_t count{}, pos{};

    dest.fill('\0');
    source.copy(dest.data(), count = 4); // pos = 0
    std::cout << dest.data() << '\n'; // ABCD

    dest.fill('\0');
    source.copy(dest.data(), count = 4, pos = 1);
    std::cout << dest.data() << '\n'; // BCDE

    dest.fill('\0');
    source.copy(dest.data(), count = 42, pos = 2); // ok, count -> 4
    std::cout << dest.data() << '\n'; // CDEF

    try
    {
        source.copy(dest.data(), count = 1, pos = 666); // throws: pos > size()
    }
    catch (std::out_of_range const& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

Вывод:

ABCD
BCDE
CDEF
basic_string_view::copy: __pos (which is 666) > __size (which is 6)

См. также

substr	возвращает подстроку (открытая функция-член)
copy	копирует символы (открытая функция-член `std::basic_string<CharT,Traits,Allocator>`)
copycopy_if (C++11)	копирует диапазон элементов в новое место (шаблон функции и функциональный объект алгоритма)
ranges::copyranges::copy_if (C++20)(C++20)
memcpy	копирует один буфер в другой (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string_view/copy