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

来自cppreference.com
 
C++
 
字符串库
 
std::basic_string_view
 
<tbody> </tbody>
constexpr basic_string_view() noexcept;
 (1) (C++17 起)
constexpr basic_string_view( const basic_string_view& other ) noexcept = default;
 (2) (C++17 起)
constexpr basic_string_view( const CharT* s, size_type count );
 (3) (C++17 起)
constexpr basic_string_view( const CharT* s );
 (4) (C++17 起)
template< class It, class End > constexpr basic_string_view( It first, End last );
 (5) (C++20 起)
template< class R > constexpr explicit basic_string_view( R&& r );
 (6) (C++23 起)
basic_string_view( std::nullptr_t ) = delete;
 (7) (C++23 起)
1) 默认构造函数。构造空的 std::basic_string_view。构造后，data() 等于 nullptr，而 size() 等于 0。
2) 复制构造函数。构造内容同 other 的视图。构造后，data() 等于 other.data()，而 size() 等于 other.size()。
3) 构造始于 s 所指向元素的字符数组的首 count 个字符的视图。s 可包含空字符。如果 [s, s + count) 不是有效范围，那么行为未定义（尽管构造函数可能不会访问此范围的任何元素）。构造后， data() 等于 s，而 size() 等于 count。
4) 构造一个 s 所指向的空终止字符串的视图，不包含终止空字符。视图的长度如同以 Traits::length(s) 确定。如果 [s, s + Traits::length(s)) 不是有效范围，那么行为未定义。构造后，data() 等于 s，而 size() 等于 Traits::length(s)。
5) 构造范围 [first, last) 上的 std::basic_string_view。如果 [first, last) 不是有效范围，It 实际上没有实现 contiguous_iterator 或 End 实际上没有实现 It 的 sized_sentinel_for，那么行为未定义。构造后 data() 等于 std::to_address(first)，而 size() 等于 last - first。
See More

此重载只有在满足以下所有条件时才会参与重载决议：

6) 构造范围 r 上的 std::basic_string_view。构造后 data() 等于 ranges::data(r)，而 size() 等于 ranges::size(r)。

此重载只有在满足以下所有条件时才会参与重载决议：

  • std::remove_cvref_t<R> 与 std::basic_string_view 不是同一类型，
  • R 实现 contiguous_range 与 sized_range，
  • ranges::range_value_t<R> 与 CharT 是同一类型，
  • R 不可转换成 const CharT* 且
  • 令 d 为 std::remove_cvref_t<R> 类型左值，d.operator ::std::basic_string_view<CharT, Traits>() 不是合法的表达式。
7) 不能从 nullptr 构造 std::basic_string_view。

参数

other - 用以初始化视图的另一视图
s - 用以初始化视图的指向字符数组或 C 字符串的指针
count - 要包含于视图的字符数
first - 指向序列首字符的迭代器
last - 指向序列尾字符后一位置的迭代器或另一哨位
r - 含有序列的连续范围

复杂度

1-3,5,6) 常数。
4) 与 s 的长度呈线性。

示例

运行此代码
#include <array>
#include <iomanip>
#include <iostream>
#include <string>
#include <string_view>

int main()
{
    std::string cppstr = "Foo";
    std::string_view cppstr_v(cppstr); // 重载 (2)，在
                                       // std::string::operator string_view 之后
    std::cout << "1) cppstr_v：" << std::quoted(cppstr_v) << '\n';

    char array[3] = {'B', 'a', 'r'};
    std::string_view array_v(array, std::size(array)); // 重载 (3)
    std::cout << "2) array_v：" << std::quoted(array_v) << '\n';

    const char* one_0_two = "One\0Two";

    std::string_view one_two_v{one_0_two, 7}; // 重载 (3)
    std::cout << "3) one_two_v：\"";
    for (char c: one_two_v)
        std::cout << (c != '\0' ? c : '?');
    std::cout << "\"，one_two_v.size()：" << one_two_v.size() << '\n';

    std::string_view one_v{one_0_two}; // 重载 (4)
    std::cout << "4) one_v：" << std::quoted(one_v) << "，one_v.size()：" 
              << one_v.size() << '\n';

    constexpr std::wstring_view wcstr_v = L"xyzzy"; // 重载 (4)
    std::cout << "5) wcstr_v.size()：" << wcstr_v.size() << '\n';

    std::array ar = {'P', 'u', 'b'};
    std::string_view ar_v(ar.begin(), ar.end()); // 重载 (5)，C++20
    std::cout << "6) ar_v：" << std::quoted(ar_v) << '\n';

//  std::string_view ar_v2{ar}; // 重载 (6)，C++23 中 OK
//  std::cout << "ar_v2：" << std::quoted(ar_v2) << '\n'; // ar_v2: "Pub"

    [[maybe_unused]] auto zero = []{ /* ... */ return nullptr; };
//  std::string_view s{zero()}; // 重载 (7)，C++23 起无法编译
}

输出： 

1) cppstr_v："Foo"
2) array_v："Bar"
3) one_two_v："One?Two"，one_two_v.size()：7
4) one_v："One"，one_v.size()：3
5) wcstr_v.size()：5
6) ar_v："Pub"

参阅

 对视图赋值
(公开成员函数) [编辑]
构造 basic_string
(std::basic_string<CharT,Traits,Allocator> 的公开成员函数) [编辑]