std::basic_string_view<CharT,Traits>::copy
从 zh.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 | - | 首个字符的位置 |
返回值
已复制的字符数。
异常
若 pos > size ( ) 则抛出 std::out_of_range 异常。
复杂度
在
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); // 正常,count -> 4 std::cout << dest.data() << '\n'; // CDEF try { source.copy(dest.data(), count = 1, pos = 666); // 抛出异常: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)
参阅
| 返回子串 (公开成员函数) | |
| 复制字符 ( std::basic_string<CharT,Traits,Allocator>的公开成员函数)
| |
(C++11) |
将元素范围复制到新位置 (函数模板 & 算法函数对象) |
(C++20)(C++20) |
|
| 将一个缓冲区复制到另一个 (函数) |