Namespaces
Variants

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>的公开成员函数)
将元素范围复制到新位置
(函数模板 & 算法函数对象)
将一个缓冲区复制到另一个
(函数)