上传cppreference

This commit is contained in:
2025-08-01 12:57:54 +08:00
parent e29892f8cd
commit 196e706fe4
5485 changed files with 982007 additions and 3 deletions

View File

@@ -0,0 +1,123 @@
<!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>operator&lt;&lt;,&gt;&gt;(std::basic_string)</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_string_basic_string_operator_ltltgtgt skin-cppreference2 action-view cpp-navbar">
<div id="cpp-content-base">
<div id="content"><a id="top"></a>
<h1 id="firstHeading" class="firstHeading">operator&lt;&lt;,&gt;&gt;<span style="font-size:0.7em; line-height:130%">(std::basic_string)</span></h1>
<div id="bodyContent">
<div id="contentSub"><span class="subpages">&lt; <a href="cpp.html">cpp</a>&lrm; | <a href="cpp-string.html">string</a>&lrm; | <a href="cpp-string-basic_string.html">basic string</a></span></div>
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
<table class="t-dcl-begin">
<tbody>
<tr class="t-dsc-header">
<td>
<div>&#23450;&#20041;&#20110;&#22836;&#25991;&#20214; <code><a href="cpp-header-string.html">&lt;string&gt;</a></code></div>
</td>
<td></td>
<td></td>
</tr>
<tr class="t-dcl">
<td>
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1">&lt;</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits, <span class="kw1">class</span> Allocator<span class="sy1">&gt;</span><br /></span>
<p><a href="cpp-io-basic_ostream.html"><span class="kw1715">std::<span class="me2">basic_ostream</span></span></a><span class="sy1">&lt;</span>CharT, Traits<span class="sy1">&gt;</span><span class="sy3">&amp;</span><br />
&nbsp; &nbsp; operator<span class="sy1">&lt;&lt;</span><span class="br0">(</span><a href="cpp-io-basic_ostream.html"><span class="kw1715">std::<span class="me2">basic_ostream</span></span></a><span class="sy1">&lt;</span>CharT, Traits<span class="sy1">&gt;</span><span class="sy3">&amp;</span> os,<br /></p>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<span class="kw4">const</span> <a href="cpp-string-basic_string.html"><span class="kw1228">std::<span class="me2">basic_string</span></span></a><span class="sy1">&lt;</span>CharT, Traits, Allocator<span class="sy1">&gt;</span><span class="sy3">&amp;</span> str<span class="br0">)</span><span class="sy4">;</span></div>
</td>
<td>(1)</td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl">
<td>
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1">&lt;</span><span class="kw1">class</span> CharT, <span class="kw1">class</span> Traits, <span class="kw1">class</span> Allocator<span class="sy1">&gt;</span><br /></span>
<p><a href="cpp-io-basic_istream.html"><span class="kw1713">std::<span class="me2">basic_istream</span></span></a><span class="sy1">&lt;</span>CharT, Traits<span class="sy1">&gt;</span><span class="sy3">&amp;</span><br />
&nbsp; &nbsp; operator<span class="sy1">&gt;&gt;</span><span class="br0">(</span><a href="cpp-io-basic_istream.html"><span class="kw1713">std::<span class="me2">basic_istream</span></span></a><span class="sy1">&lt;</span>CharT, Traits<span class="sy1">&gt;</span><span class="sy3">&amp;</span> is,<br /></p>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<a href="cpp-string-basic_string.html"><span class="kw1228">std::<span class="me2">basic_string</span></span></a><span class="sy1">&lt;</span>CharT, Traits, Allocator<span class="sy1">&gt;</span><span class="sy3">&amp;</span> str<span class="br0">)</span><span class="sy4">;</span></div>
</td>
<td>(2)</td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>1) &#34920;&#29616;&#20026;<a href="cpp-named_req-FormattedOutputFunction.html"><span style="font-style:italic">&#26377;&#26684;&#24335;&#36755;&#20986;&#20989;&#25968;</span> <span style="font-family: Georgia, &#39;DejaVu Serif&#39;, serif; font-style:italic">(FormattedOutputFunction)</span></a> &#12290;&#26500;&#36896;&#24182;&#26816;&#26597; sentry &#23545;&#35937;&#21518;&#65292;&#20197;&#22914;&#19979;&#26041;&#24335;&#30830;&#23450;&#36755;&#20986;&#26684;&#24335;&#22635;&#20805;&#65306;</p>
<dl>
<dd>a) &#33509; <code>str.size()</code> &#19981;&#23567;&#20110; <code>os.width()</code> &#65292;&#21017;&#21407;&#26679;&#22320;&#20351;&#29992;&#33539;&#22260; <code>[str.begin(), str.end())</code></dd>
<dd>b) &#21542;&#21017;&#65292;&#33509; <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="br0">(</span>os.<span class="me1">flags</span><span class="br0">(</span><span class="br0">)</span> <span class="sy3">&amp;</span> ios_base<span class="sy4">::</span><span class="me2">adjustfield</span><span class="br0">)</span> <span class="sy1">==</span> ios_base<span class="sy4">::</span><span class="me2">left</span></span></span> &#65292;&#21017;&#25918;&#32622; <code>os.width()-str.size()</code> &#20010; <code>os.fill()</code> &#23383;&#31526;&#30340;&#21103;&#26412;&#21040;&#23383;&#31526;&#24207;&#21015;&#21518;</dd>
<dd>c) &#21542;&#21017;&#65292;&#25918;&#32622; <code>os.width()-str.size()</code> &#20010; <code>os.fill()</code> &#23383;&#31526;&#21103;&#26412;&#21040;&#23383;&#31526;&#24207;&#21015;&#21069;</dd>
</dl>
<p>&#28982;&#21518;&#23384;&#20648;&#27599;&#20010;&#26469;&#33258;&#32467;&#26524;&#24207;&#21015;&#65288; <code>str</code> &#30340;&#20869;&#23481;&#21152;&#19978;&#22635;&#20805;&#65289;&#21040;&#36755;&#20986;&#27969; <code>os</code> &#65292;&#22914;&#21516;&#36890;&#36807;&#35843;&#29992; <span class="t-c"><span class="mw-geshi cpp source-cpp">os.<span class="me1">rdbuf</span><span class="br0">(</span><span class="br0">)</span><span class="sy2">-</span><span class="sy1">&gt;</span>sputn<span class="br0">(</span>seq, n<span class="br0">)</span></span></span> &#65292;&#20854;&#20013; <span class="t-c"><span class="mw-geshi cpp source-cpp">n<span class="sy1">=</span><a href="cpp-algorithm-max.html"><span class="kw1640">std::<span class="me2">max</span></span></a><span class="br0">(</span>os.<span class="me1">width</span><span class="br0">(</span><span class="br0">)</span>, str.<span class="me1">size</span><span class="br0">(</span><span class="br0">)</span><span class="br0">)</span></span></span></p>
<p>&#26368;&#21518;&#65292;&#35843;&#29992; <span class="t-c"><span class="mw-geshi cpp source-cpp">os.<span class="me1">width</span><span class="br0">(</span><span class="nu0">0</span><span class="br0">)</span></span></span> &#21462;&#28040; <span class="t-lc"><a href="cpp-io-manip-setw.html">std::setw</a></span> &#30340;&#25928;&#26524;&#65292;&#33509;&#23384;&#22312;&#12290;</p>
<p>2) &#34920;&#29616;&#20026;<a href="cpp-named_req-FormattedInputFunction.html"><span style="font-style:italic">&#26377;&#26684;&#24335;&#36755;&#20837;&#20989;&#25968;</span> <span style="font-family: Georgia, &#39;DejaVu Serif&#39;, serif; font-style:italic">(FormattedInputFunction)</span></a> &#12290;&#26500;&#36896;&#24182;&#26816;&#26597; sentry &#23545;&#35937;&#65292;&#36825;&#21487;&#33021;&#36339;&#36807;&#21069;&#23548;&#31354;&#30333;&#31526;&#65292;&#28982;&#21518;&#39318;&#20808;&#20197; <span class="t-c"><span class="mw-geshi cpp source-cpp">str.<span class="me1">erase</span><span class="br0">(</span><span class="br0">)</span></span></span> &#28165;&#38500; <code>str</code> &#65292;&#28982;&#21518;&#20174; <code>is</code> &#35835;&#21462;&#23383;&#31526;&#24182;&#21518;&#38468;&#23427;&#20204;&#21040; <code>str</code> &#65292;&#22914;&#21516;&#29992; <span class="t-c"><span class="mw-geshi cpp source-cpp">str.<span class="me1">append</span><span class="br0">(</span><span class="nu0">1</span>, c<span class="br0">)</span></span></span> &#65292;&#30452;&#33267;&#19979;&#21015;&#26465;&#20214;&#20043;&#19968;&#21464;&#20026;&#30495;&#65306;</p>
<ul>
<li>&#35835;&#21462;&#20102; <code>N</code> &#20010;&#23383;&#31526;&#65292;&#20854;&#20013;&#33509; <code>is.width() &gt; 0</code> &#21017; <code>N</code> &#20026; <code>is.width()</code> &#65292;&#21542;&#21017; <code>N</code> &#20026; <code>str.max_size()</code></li>
<li>&#27969; <code>is</code> &#20013;&#20986;&#29616;&#25991;&#20214;&#23614;&#26465;&#20214;</li>
<li><span class="t-c"><span class="mw-geshi cpp source-cpp">std<span class="sy4">::</span><span class="me2">isspace</span><span class="br0">(</span>c,is.<span class="me1">getloc</span><span class="br0">(</span><span class="br0">)</span><span class="br0">)</span></span></span> &#23545; <code>is</code> &#20013;&#30340;&#19979;&#20010;&#23383;&#31526; <code>c</code> &#20026; true &#65288;&#31354;&#30333;&#31526;&#30041;&#22312;&#36755;&#20837;&#27969;&#20013;&#65289;&#12290;</li>
</ul>
<p>&#33509;&#26410;&#37322;&#20986;&#23383;&#31526;&#65292;&#21017;&#35774;&#32622; <code>is</code> &#19978;&#30340; <span class="t-c"><span class="mw-geshi cpp source-cpp">std<span class="sy4">::</span><span class="me2">ios</span><span class="sy4">::</span><span class="me2">failbit</span></span></span> &#65292;&#36825;&#21487;&#33021;&#25243;&#20986; <span class="t-lc"><a href="cpp-io-ios_base-failure.html">std::ios_base::failure</a></span> &#12290;</p>
<p>&#26368;&#21518;&#65292;&#35843;&#29992; <span class="t-c"><span class="mw-geshi cpp source-cpp">is.<span class="me1">width</span><span class="br0">(</span><span class="nu0">0</span><span class="br0">)</span></span></span> &#21462;&#28040; <span class="t-lc"><a href="cpp-io-manip-setw.html">std::setw</a></span> &#30340;&#25928;&#26524;&#65292;&#33509;&#23384;&#22312;&#12290;</p>
<h3><span class="mw-headline" id=".E5.BC.82.E5.B8.B8">&#24322;&#24120;</span></h3>
<p>1) &#33509;&#36755;&#20986;&#20013;&#25243;&#20986;&#24322;&#24120;&#21017;&#21487;&#33021;&#25243;&#20986; <span class="t-lc"><a href="cpp-io-ios_base-failure.html">std::ios_base::failure</a></span> &#12290;</p>
<p>2) &#33509;&#26410;&#20174; <code>is</code> &#37322;&#20986;&#23383;&#31526;&#65288;&#20363;&#22914;&#27969;&#22312;&#25991;&#20214;&#23614;&#25110;&#20165;&#26377;&#31354;&#30333;&#31526;&#32452;&#25104;&#65289;&#65292;&#25110;&#33509;&#36755;&#20837;&#20013;&#25243;&#20986;&#24322;&#24120;&#21017;&#21487;&#33021;&#25243;&#20986; <span class="t-lc"><a href="cpp-io-ios_base-failure.html">std::ios_base::failure</a></span> &#12290;</p>
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">&#21442;&#25968;</span></h3>
<table class="t-par-begin">
<tr class="t-par">
<td>os</td>
<td>-</td>
<td>&#23383;&#31526;&#36755;&#20986;&#27969;</td>
</tr>
<tr class="t-par">
<td>is</td>
<td>-</td>
<td>&#23383;&#31526;&#36755;&#20837;&#27969;</td>
</tr>
<tr class="t-par">
<td>str</td>
<td>-</td>
<td>&#25554;&#20837;&#25110;&#37322;&#20986;&#30340;&#23383;&#31526;&#20018;</td>
</tr>
</table>
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">&#36820;&#22238;&#20540;</span></h3>
<p>1) <code>os</code></p>
<p>2) <code>is</code></p>
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">&#31034;&#20363;</span></h3>
<div class="t-example">
<div class="t-example-live-link"></div>
<div dir="ltr" class="mw-geshi" style="text-align: left;">
<div class="cpp source-cpp">
<pre class="de1"><span class="co2">#include &lt;iostream&gt;</span>
<span class="co2">#include &lt;string&gt;</span>
<span class="co2">#include &lt;sstream&gt;</span>
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
<span class="br0">{</span>
<a href="cpp-string-basic_string.html"><span class="kw1230">std::<span class="me2">string</span></span></a> greeting <span class="sy1">=</span> <span class="st0">&quot;Hello, whirled!&quot;</span><span class="sy4">;</span>
<a href="cpp-io-basic_istringstream.html"><span class="kw1735">std::<span class="me2">istringstream</span></span></a> is<span class="br0">(</span>greeting<span class="br0">)</span><span class="sy4">;</span>
<a href="cpp-string-basic_string.html"><span class="kw1230">std::<span class="me2">string</span></span></a> hello_comma<span class="sy4">;</span>
is <span class="sy1">&gt;&gt;</span> hello_comma<span class="sy4">;</span>
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> greeting <span class="sy1">&lt;&lt;</span> <span class="st0">&#39;<span class="es1">\n</span>&#39;</span> <span class="sy1">&lt;&lt;</span> hello_comma <span class="sy1">&lt;&lt;</span> <span class="st0">&#39;<span class="es1">\n</span>&#39;</span><span class="sy4">;</span>
<span class="br0">}</span></pre></div>
</div>
<p>&#36755;&#20986;&#65306;</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;">
<div class="text source-text">
<pre class="de1">Hello, whirled!
Hello,</pre></div>
</div>
</div>
</div>
<div class="visualClear"></div>
</div>
</div>
</div>
</body>
</html>