std::basic_string_view<CharT,Traits>::copy
С сайта ru.cppreference.net
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)
См. также
| возвращает подстроку (public функция-элемент) | |
| копирует символы (public функция-элемент класса std::basic_string<CharT,Traits,Allocator>)
| |
(C++11) |
копирует диапазон элементов в новое расположение (шаблон функции & функциональный объект алгоритма) |
(C++20)(C++20) |
|
| копирует один буфер в другой (функция) |