142 lines
12 KiB
HTML
142 lines
12 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>std::strstreambuf::freeze</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_io_strstreambuf_freeze 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%">std::strstreambuf::</span>freeze</h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-io.html">io</a>‎ | <a href="cpp-io-strstreambuf.html">strstreambuf</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-dcl">
|
|
<td class="t-dcl-nopad">
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw4">void</span> freeze<span class="br0">(</span> <span class="kw4">bool</span> freezefl <span class="sy1">=</span> <span class="kw2">true</span> <span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td class="t-dcl-nopad"></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>若缓冲区使用动态分配,则设置流的冻结状态为 <code>freezefl</code> 。</p>
|
|
<p>流冻结时, <span class="t-lc"><a href="cpp-io-strstreambuf-overflow.html">overflow()</a></span> 不会重分配缓冲区,而<a href="cpp-io-strstreambuf-~strstreambuf.html">析构函数</a>不会解分配缓冲区(因而导致内存泄漏)。</p>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">参数</span></h3>
|
|
<table class="t-par-begin">
|
|
<tr class="t-par">
|
|
<td>freezefl</td>
|
|
<td>-</td>
|
|
<td>设置冻结状态到的新值</td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">返回值</span></h3>
|
|
<p>(无)</p>
|
|
<h3><span class="mw-headline" id=".E6.B3.A8.E6.84.8F">注意</span></h3>
|
|
<p>每次对 <span class="t-lc"><a href="cpp-io-strstreambuf-str.html">str()</a></span> 的调用都冻结流,以保持其所返回的指针的合法性。为允许析构函数解分配缓冲区,需要显式调用 <span class="t-lc"><strong class="selflink">freeze(false)</strong></span> 。</p>
|
|
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
|
|
<div class="t-example">
|
|
<p>此示例中,底层数组的初始分配为 16 字节</p>
|
|
<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 <strstream></span>
|
|
<span class="co2">#include <iostream></span>
|
|
|
|
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="br0">{</span>
|
|
<a href="cpp-io-strstream.html"><span class="kw1755">std::<span class="me2">strstream</span></span></a> dyn<span class="sy4">;</span> <span class="co1">// 动态分配的读/写缓冲区</span>
|
|
dyn <span class="sy1"><<</span> <span class="st0">"Test: "</span> <span class="sy1"><<</span> <span class="nu16">1.23</span><span class="sy4">;</span> <span class="co1">// 注意:无 std::ends ,以演示后附行为</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"dynamic buffer holds "</span> <span class="sy1"><<</span> dyn.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">" characters: '"</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a>.<span class="me1">write</span><span class="br0">(</span>dyn.<span class="me1">str</span><span class="br0">(</span><span class="br0">)</span>, dyn.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">"'<span class="es1">\n</span>"</span><span class="sy4">;</span>
|
|
<span class="co1">// 缓冲区现在冻结,进一步输出将不使缓冲区增长</span>
|
|
dyn <span class="sy1"><<</span> <span class="st0">"more output, hopefully enough to run out of the allocated space"</span> <span class="sy1"><<</span> <a href="cpp-io-manip-ends.html"><span class="kw1789">std::<span class="me2">ends</span></span></a><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"After more output, it holds "</span>
|
|
<span class="sy1"><<</span> dyn.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">" characters: '"</span> <span class="sy1"><<</span> dyn.<span class="me1">str</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">"'<span class="es1">\n</span>"</span><span class="sy4">;</span>
|
|
dyn.<span class="me1">freeze</span><span class="br0">(</span><span class="kw2">false</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 在析构函数前解冻</span>
|
|
<span class="br0">}</span> <span class="co1">// 析构函数释放内存</span>
|
|
|
|
<span class="br0">{</span>
|
|
<span class="kw4">char</span> arr<span class="br0">[</span><span class="nu0">20</span><span class="br0">]</span><span class="sy4">;</span>
|
|
<a href="cpp-io-ostrstream.html"><span class="kw1754">std::<span class="me2">ostrstream</span></span></a> st<span class="br0">(</span>arr, sizeof arr<span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 固定大小缓冲区</span>
|
|
st <span class="sy1"><<</span> <span class="nu16">1.23</span><span class="sy4">;</span> <span class="co1">// 注意:无 std::ends ,以演示后附行为</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"static buffer holds "</span>
|
|
<span class="sy1"><<</span> st.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">" characters: '"</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a>.<span class="me1">write</span><span class="br0">(</span>st.<span class="me1">str</span><span class="br0">(</span><span class="br0">)</span>, st.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"'<span class="es1">\n</span>"</span><span class="sy4">;</span>
|
|
st <span class="sy1"><<</span> <span class="st0">"more output, hopefully enough to run out of the allocated space"</span> <span class="sy1"><<</span> <a href="cpp-io-manip-ends.html"><span class="kw1789">std::<span class="me2">ends</span></span></a><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"static buffer holds "</span>
|
|
<span class="sy1"><<</span> st.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1"><<</span> <span class="st0">" characters: '"</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a>.<span class="me1">write</span><span class="br0">(</span>st.<span class="me1">str</span><span class="br0">(</span><span class="br0">)</span>, st.<span class="me1">pcount</span><span class="br0">(</span><span class="br0">)</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"'<span class="es1">\n</span>"</span><span class="sy4">;</span>
|
|
<span class="br0">}</span> <span class="co1">// 无待解分配者,无需解冻</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<p>输出:</p>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="text source-text">
|
|
<pre class="de1">dynamic buffer holds 10 characters: 'Test: 1.23'
|
|
After more output, it holds 16 characters: 'Test: 1.23more o'
|
|
static buffer holds 4 characters: '1.23'
|
|
static buffer holds 20 characters: '1.23more output, hop'</pre></div>
|
|
</div>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E9.98.85">参阅</span></h3>
|
|
<table class="t-dsc-begin">
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-io-strstream-freeze.html"><span class="t-lines"><span>freeze</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>禁用/启用自动解分配<br />
|
|
<span class="t-mark">(<code>std::strstream</code> 的公开成员函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-io-ostrstream-freeze.html"><span class="t-lines"><span>freeze</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>禁用/启用自动解分配<br />
|
|
<span class="t-mark">(<code>std::ostrstream</code> 的公开成员函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div t-dsc-member-nobold-div">
|
|
<div><a href="cpp-io-strstreambuf-~strstreambuf.html"><span class="t-lines"><span>(析构函数)</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-cmark">[虚]</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>销毁 strstreambuf 对象,可选地解分配字符数组<br />
|
|
<span class="t-mark">(虚公开成员函数)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-io-strstreambuf-overflow.html"><span class="t-lines"><span>overflow</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-cmark">[虚]</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>后附字符到输出序列,可能重分配或初始地分配缓冲区,若它为动态且未被冻结<br />
|
|
<span class="t-mark">(虚受保护成员函数)</span></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|