426 lines
42 KiB
HTML
426 lines
42 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
|
|
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>标准库头文件 <string_view></title>
|
|
<link rel="stylesheet" href="ext.css" />
|
|
<link rel="stylesheet" href="site_modules.css" />
|
|
</head>
|
|
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_header_string_view skin-cppreference2 action-view cpp-navbar">
|
|
<div id="cpp-content-base">
|
|
<div id="content"><a id="top"></a>
|
|
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">标准库头文件</span> <string_view></h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-header.html">header</a></span></div>
|
|
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
|
<p>此头文件是<a href="cpp-string.html">字符串</a>库的一部分。</p>
|
|
<table class="t-dsc-begin">
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.8C.85.E5.90.AB">包含</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-header-compare.html"><span class="t-lines"><span><compare></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td><a href="cpp-language-operator_comparison.html#.E4.B8.89.E8.B7.AF.E6.AF.94.E8.BE.83">三路比较运算符</a>支持</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E7.B1.BB">类</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-string-basic_string_view.html"><span class="t-lines"><span>basic_string_view</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>只读的字符串视图<br />
|
|
<span class="t-mark">(类模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><span class="t-lc"><a href="cpp-string-basic_string_view.html">std::string_view</a></span> <span class="t-mark-rev t-since-cxx17">(C++17)</span></td>
|
|
<td><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-string-basic_string_view.html"><span class="kw1246">std::<span class="me2">basic_string_view</span></span></a><span class="sy1"><</span><span class="kw4">char</span><span class="sy1">></span></span></span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><span class="t-lc">std::u8string_view</span> <span class="t-mark-rev t-since-cxx20">(C++20)</span></td>
|
|
<td><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-string-basic_string_view.html"><span class="kw1246">std::<span class="me2">basic_string_view</span></span></a><span class="sy1"><</span>char8_t<span class="sy1">></span></span></span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><span class="t-lc"><a href="cpp-string-basic_string_view.html">std::u16string_view</a></span> <span class="t-mark-rev t-since-cxx17">(C++17)</span></td>
|
|
<td><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-string-basic_string_view.html"><span class="kw1246">std::<span class="me2">basic_string_view</span></span></a><span class="sy1"><</span><span class="kw4">char16_t</span><span class="sy1">></span></span></span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><span class="t-lc"><a href="cpp-string-basic_string_view.html">std::u32string_view</a></span> <span class="t-mark-rev t-since-cxx17">(C++17)</span></td>
|
|
<td><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-string-basic_string_view.html"><span class="kw1246">std::<span class="me2">basic_string_view</span></span></a><span class="sy1"><</span><span class="kw4">char32_t</span><span class="sy1">></span></span></span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><span class="t-lc"><a href="cpp-string-basic_string_view.html">std::wstring_view</a></span> <span class="t-mark-rev t-since-cxx17">(C++17)</span></td>
|
|
<td><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-string-basic_string_view.html"><span class="kw1246">std::<span class="me2">basic_string_view</span></span></a><span class="sy1"><</span><span class="kw4">wchar_t</span><span class="sy1">></span></span></span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-string-basic_string_view-hash.html"><span class="t-lines"><span>std::hash<span class="t-dsc-small"><std::string_view></span></span><span>std::hash<span class="t-dsc-small"><std::wstring_view></span></span><span>std::hash<span class="t-dsc-small"><std::u8string_view></span></span><span>std::hash<span class="t-dsc-small"><std::u16string_view></span></span><span>std::hash<span class="t-dsc-small"><std::u32string_view></span></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>string_view 的散列支持<br />
|
|
<span class="t-mark">(类模板特化)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h5><span class="mw-headline" id=".E5.89.8D.E7.BD.AE.E5.A3.B0.E6.98.8E">前置声明</span></h5>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc-header">
|
|
<td colspan="2">
|
|
<div>定义于头文件 <code><a href="cpp-header-functional.html"><functional></a></code></div>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-hash.html"><span class="t-lines"><span>hash</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>散列函数对象<br />
|
|
<span class="t-mark">(类模板)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.87.BD.E6.95.B0">函数</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-string-basic_string_view-operator_cmp.html"><span class="t-lines"><span>operator==</span><span>operator!=</span><span>operator<</span><span>operator></span><span>operator<=</span><span>operator>=</span><span>operator<=></span></span></a></div>
|
|
<div><span class="t-lines"><span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>以字典序比较两个字符串视图<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-string-basic_string_view-operator_ltlt.html"><span class="t-lines"><span>operator<<</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>进行字符串视图的流输出<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-algorithm-swap.html"><span class="t-lines"><span>swap</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>交换两个对象的值<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h5><span class="mw-headline" id=".E8.8C.83.E5.9B.B4.E8.AE.BF.E9.97.AE">范围访问</span></h5>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-begin.html"><span class="t-lines"><span>begin</span><span>cbegin</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回指向容器或数组起始的迭代器<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-end.html"><span class="t-lines"><span>end</span><span>cend</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回指向容器或数组结尾的迭代器<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-rbegin.html"><span class="t-lines"><span>rbegin</span><span>crbegin</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回指向一个容器或数组的逆向迭代器<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-rend.html"><span class="t-lines"><span>rend</span><span>crend</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx14">(C++14)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回容器或数组的逆向尾迭代器<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-size.html"><span class="t-lines"><span>size</span><span>ssize</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>返回容器或数组的大小<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-empty.html"><span class="t-lines"><span>empty</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>检查容器是否为空<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-iterator-data.html"><span class="t-lines"><span>data</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>获得指向底层数组的指针<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h5><span class="mw-headline" id=".E5.AD.97.E9.9D.A2.E9.87.8F">字面量</span></h5>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc-header">
|
|
<td colspan="2">
|
|
<div>定义于内联命名空间 <code>std::literals::string_view_literals</code></div>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-string-basic_string_view-operator_22_22sv.html"><span class="t-lines"><span>operator""sv</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>创建一个字符数组字面量的字符串视图<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E6.A6.82.E8.A6.81">概要</span></h3>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="co2">#include <compare></span>
|
|
|
|
<span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="co1">// 类模板 basic_­string_­view</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits <span class="sy1">=</span> char_traits<span class="sy1"><</span>CharT<span class="sy1">>></span>
|
|
<span class="kw1">class</span> basic_string_view<span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits<span class="sy1">></span>
|
|
<span class="kw1">inline</span> <span class="kw4">constexpr</span> <span class="kw4">bool</span> ranges<span class="sy4">::</span><span class="me2">enable_view</span><span class="sy1"><</span>basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">>></span> <span class="sy1">=</span> <span class="kw2">true</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits<span class="sy1">></span>
|
|
<span class="kw1">inline</span> <span class="kw4">constexpr</span> <span class="kw4">bool</span> ranges<span class="sy4">::</span><span class="me2">enable_borrowed_range</span><span class="sy1"><</span>basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">>></span> <span class="sy1">=</span>
|
|
<span class="kw2">true</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 非成员函数</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> operator<span class="sy1">==</span><span class="br0">(</span>basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">></span> x,
|
|
basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">></span> y<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="coMULTI">/* 见描述 */</span>
|
|
operator<span class="sy1"><=></span><span class="br0">(</span>basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">></span> x,
|
|
basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">></span> y<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 充足的比较函数额外重载</span>
|
|
|
|
<span class="co1">// 插入器与提取器</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits<span class="sy1">></span>
|
|
basic_ostream<span class="sy1"><</span>CharT, Traits<span class="sy1">></span><span class="sy3">&</span>
|
|
operator<span class="sy1"><<</span><span class="br0">(</span>basic_ostream<span class="sy1"><</span>CharT, Traits<span class="sy1">></span><span class="sy3">&</span> os,
|
|
basic_string_view<span class="sy1"><</span>CharT, Traits<span class="sy1">></span> str<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// basic_­string_­view typedef 名</span>
|
|
<span class="kw1">using</span> string_view <span class="sy1">=</span> basic_string_view<span class="sy1"><</span><span class="kw4">char</span><span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> u8string_view <span class="sy1">=</span> basic_string_view<span class="sy1"><</span>char8_t<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> u16string_view <span class="sy1">=</span> basic_string_view<span class="sy1"><</span><span class="kw4">char16_t</span><span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> u32string_view <span class="sy1">=</span> basic_string_view<span class="sy1"><</span><span class="kw4">char32_t</span><span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> wstring_view <span class="sy1">=</span> basic_string_view<span class="sy1"><</span><span class="kw4">wchar_t</span><span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 散列支持</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">struct</span> hash<span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><></span> <span class="kw1">struct</span> hash<span class="sy1"><</span>string_view<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><></span> <span class="kw1">struct</span> hash<span class="sy1"><</span>u8string_view<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><></span> <span class="kw1">struct</span> hash<span class="sy1"><</span>u16string_view<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><></span> <span class="kw1">struct</span> hash<span class="sy1"><</span>u32string_view<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><></span> <span class="kw1">struct</span> hash<span class="sy1"><</span>wstring_view<span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">inline</span> <span class="kw1">namespace</span> literals <span class="br0">{</span>
|
|
<span class="kw1">inline</span> <span class="kw1">namespace</span> string_view_literals <span class="br0">{</span>
|
|
<span class="co1">// basic_­string_­view 字面量的后缀</span>
|
|
<span class="kw4">constexpr</span> string_view operator<span class="st0">""</span>sv<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span> str, size_t len<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> u8string_view operator<span class="st0">""</span>sv<span class="br0">(</span><span class="kw4">const</span> char8_t<span class="sy2">*</span> str, size_t len<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> u16string_view operator<span class="st0">""</span>sv<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char16_t</span><span class="sy2">*</span> str, size_t len<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> u32string_view operator<span class="st0">""</span>sv<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">char32_t</span><span class="sy2">*</span> str, size_t len<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> wstring_view operator<span class="st0">""</span>sv<span class="br0">(</span><span class="kw4">const</span> <span class="kw4">wchar_t</span><span class="sy2">*</span> str, size_t len<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="br0">}</span>
|
|
<span class="br0">}</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<h4><span class="mw-headline" id=".E7.B1.BB.E6.A8.A1.E6.9D.BF_std::basic_string_view">类模板 <span class="t-lc"><a href="cpp-string-basic_string_view.html">std::basic_string_view</a></span></span></h4>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits <span class="sy1">=</span> char_traits<span class="sy1"><</span>CharT<span class="sy1">>></span>
|
|
<span class="kw1">class</span> basic_string_view <span class="br0">{</span>
|
|
<span class="kw1">public</span><span class="sy4">:</span>
|
|
<span class="co1">// 类型</span>
|
|
<span class="kw1">using</span> Traits_type <span class="sy1">=</span> Traits<span class="sy4">;</span>
|
|
<span class="kw1">using</span> value_type <span class="sy1">=</span> CharT<span class="sy4">;</span>
|
|
<span class="kw1">using</span> pointer <span class="sy1">=</span> value_type<span class="sy2">*</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> const_pointer <span class="sy1">=</span> <span class="kw4">const</span> value_type<span class="sy2">*</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> reference <span class="sy1">=</span> value_type<span class="sy3">&</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> const_reference <span class="sy1">=</span> <span class="kw4">const</span> value_type<span class="sy3">&</span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> const_iterator <span class="sy1">=</span> <span class="coMULTI">/* 由实现定义 */</span>
|
|
<span class="kw1">using</span> iterator <span class="sy1">=</span> const_iterator<span class="sy4">;</span>
|
|
<span class="kw1">using</span> const_reverse_iterator <span class="sy1">=</span> reverse_iterator<span class="sy1"><</span>const_iterator<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">using</span> reverse_iterator <span class="sy1">=</span> const_reverse_iterator<span class="sy4">;</span>
|
|
<span class="kw1">using</span> size_type <span class="sy1">=</span> size_t<span class="sy4">;</span>
|
|
<span class="kw1">using</span> difference_type <span class="sy1">=</span> ptrdiff_t<span class="sy4">;</span>
|
|
<span class="kw4">static</span> <span class="kw4">constexpr</span> size_type npos <span class="sy1">=</span> size_type<span class="br0">(</span><span class="sy2">-</span><span class="nu0">1</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 构造与赋值</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span><span class="kw4">const</span> basic_string_view<span class="sy3">&</span><span class="br0">)</span> <span class="kw1">noexcept</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> basic_string_view<span class="sy3">&</span><span class="br0">)</span> <span class="kw1">noexcept</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> str<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span>nullptr_t<span class="br0">)</span> <span class="sy1">=</span> delete<span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> str, size_type len<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> It, <span class="kw1">class</span> End<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span>It begin, End end<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> R<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> basic_string_view<span class="br0">(</span>R<span class="sy3">&&</span> r<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 迭代器支持</span>
|
|
<span class="kw4">constexpr</span> const_iterator begin<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_iterator end<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_iterator cbegin<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_iterator cend<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reverse_iterator rbegin<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reverse_iterator rend<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reverse_iterator crbegin<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reverse_iterator crend<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 容量</span>
|
|
<span class="kw4">constexpr</span> size_type size<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type length<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type max_size<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="br0">[</span><span class="br0">[</span>nodiscard<span class="br0">]</span><span class="br0">]</span> <span class="kw4">constexpr</span> <span class="kw4">bool</span> empty<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 元素访问</span>
|
|
<span class="kw4">constexpr</span> const_reference operator<span class="br0">[</span><span class="br0">]</span><span class="br0">(</span>size_type pos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reference at<span class="br0">(</span>size_type pos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reference front<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_reference back<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> const_pointer data<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 修改器</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">void</span> remove_prefix<span class="br0">(</span>size_type n<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">void</span> remove_suffix<span class="br0">(</span>size_type n<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">void</span> swap<span class="br0">(</span>basic_string_view<span class="sy3">&</span> s<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 字符串操作</span>
|
|
<span class="kw4">constexpr</span> size_type copy<span class="br0">(</span>CharT<span class="sy2">*</span> s, size_type n, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw4">constexpr</span> basic_string_view substr<span class="br0">(</span>size_type pos <span class="sy1">=</span> <span class="nu0">0</span>, size_type n <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span>basic_string_view s<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span>size_type pos1, size_type n1, basic_string_view s<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span>size_type pos1, size_type n1, basic_string_view s,
|
|
size_type pos2, size_type n2<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span>size_type pos1, size_type n1, <span class="kw4">const</span> CharT<span class="sy2">*</span> s<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">int</span> compare<span class="br0">(</span>size_type pos1, size_type n1, <span class="kw4">const</span> CharT<span class="sy2">*</span> s,
|
|
size_type n2<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> starts_with<span class="br0">(</span>basic_string_view x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> starts_with<span class="br0">(</span>CharT x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> starts_with<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> x<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> ends_with<span class="br0">(</span>basic_string_view x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> ends_with<span class="br0">(</span>CharT x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> ends_with<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> x<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> contains<span class="br0">(</span>basic_string_view x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> contains<span class="br0">(</span>CharT x<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> contains<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> x<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 搜索</span>
|
|
<span class="kw4">constexpr</span> size_type find<span class="br0">(</span>basic_string_view s, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos, size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type rfind<span class="br0">(</span>basic_string_view s, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type rfind<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type rfind<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos, size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type rfind<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw4">constexpr</span> size_type find_first_of<span class="br0">(</span>basic_string_view s,
|
|
size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_of<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos, size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_of<span class="br0">(</span>basic_string_view s,
|
|
size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_of<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos, size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_not_of<span class="br0">(</span>basic_string_view s,
|
|
size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_not_of<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_not_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos,
|
|
size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_first_not_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> <span class="nu0">0</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_not_of<span class="br0">(</span>basic_string_view s,
|
|
size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_not_of<span class="br0">(</span>CharT c, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_not_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos,
|
|
size_type n<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> size_type find_last_not_of<span class="br0">(</span><span class="kw4">const</span> CharT<span class="sy2">*</span> s, size_type pos <span class="sy1">=</span> npos<span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">private</span><span class="sy4">:</span>
|
|
const_pointer data_<span class="sy4">;</span> <span class="co1">// 仅用于阐释</span>
|
|
size_type size_<span class="sy4">;</span> <span class="co1">// 仅用于阐释</span>
|
|
<span class="br0">}</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 推导指引</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> It, <span class="kw1">class</span> End<span class="sy1">></span>
|
|
basic_string_view<span class="br0">(</span>It, End<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> basic_string_view<span class="sy1"><</span>iter_value_t<span class="sy1"><</span>It<span class="sy1">>></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> R<span class="sy1">></span>
|
|
basic_string_view<span class="br0">(</span>R<span class="sy3">&&</span><span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> basic_string_view<span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">range_value_t</span><span class="sy1"><</span>R<span class="sy1">>></span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|