1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>buffers_prefix</title> 5<link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css"> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="../../index.html" title="Chapter 1. Boost.Beast"> 8<link rel="up" href="../ref.html" title="This Page Intentionally Left Blank 2/2"> 9<link rel="prev" href="boost__beast__buffers_cat.html" title="buffers_cat"> 10<link rel="next" href="boost__beast__buffers_front.html" title="buffers_front"> 11</head> 12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 13<table cellpadding="2" width="100%"><tr> 14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td> 15<td align="center"><a href="../../../../../../index.html">Home</a></td> 16<td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td> 17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 19<td align="center"><a href="../../../../../../more/index.htm">More</a></td> 20</tr></table> 21<hr> 22<div class="spirit-nav"> 23<a accesskey="p" href="boost__beast__buffers_cat.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../ref.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost__beast__buffers_front.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h4 class="title"> 27<a name="beast.ref.boost__beast__buffers_prefix"></a><a class="link" href="boost__beast__buffers_prefix.html" title="buffers_prefix">buffers_prefix</a> 28</h4></div></div></div> 29<p> 30 <a class="indexterm" name="idm46057513218288"></a> 31 </p> 32<p> 33 Returns a prefix of a constant or mutable buffer sequence. 34 </p> 35<h5> 36<a name="beast.ref.boost__beast__buffers_prefix.h0"></a> 37 <span class="phrase"><a name="beast.ref.boost__beast__buffers_prefix.synopsis"></a></span><a class="link" href="boost__beast__buffers_prefix.html#beast.ref.boost__beast__buffers_prefix.synopsis">Synopsis</a> 38 </h5> 39<p> 40 Defined in header <code class="literal"><<a href="../../../../../../boost/beast/core/buffers_prefix.hpp" target="_top">boost/beast/core/buffers_prefix.hpp</a>></code> 41 </p> 42<pre class="programlisting"><span class="keyword">template</span><span class="special"><</span> 43 <span class="keyword">class</span> <a class="link" href="../concepts/BufferSequence.html" title="BufferSequence"><span class="emphasis"><em>BufferSequence</em></span></a><span class="special">></span> 44<span class="identifier">buffers_prefix_view</span><span class="special"><</span> <span class="identifier">BufferSequence</span> <span class="special">></span> 45<span class="identifier">buffers_prefix</span><span class="special">(</span> 46 <span class="identifier">std</span><span class="special">::</span><span class="identifier">size_t</span> <span class="identifier">size</span><span class="special">,</span> 47 <span class="identifier">BufferSequence</span> <span class="keyword">const</span><span class="special">&</span> <span class="identifier">buffers</span><span class="special">);</span> 48</pre> 49<h5> 50<a name="beast.ref.boost__beast__buffers_prefix.h1"></a> 51 <span class="phrase"><a name="beast.ref.boost__beast__buffers_prefix.description"></a></span><a class="link" href="boost__beast__buffers_prefix.html#beast.ref.boost__beast__buffers_prefix.description">Description</a> 52 </h5> 53<p> 54 The returned buffer sequence points to the same memory as the passed buffer 55 sequence, but with a size that is equal to or smaller. No memory allocations 56 are performed; the resulting sequence is calculated as a lazy range. 57 </p> 58<h5> 59<a name="beast.ref.boost__beast__buffers_prefix.h2"></a> 60 <span class="phrase"><a name="beast.ref.boost__beast__buffers_prefix.parameters"></a></span><a class="link" href="boost__beast__buffers_prefix.html#beast.ref.boost__beast__buffers_prefix.parameters">Parameters</a> 61 </h5> 62<div class="informaltable"><table class="table"> 63<colgroup> 64<col> 65<col> 66</colgroup> 67<thead><tr> 68<th> 69 <p> 70 Name 71 </p> 72 </th> 73<th> 74 <p> 75 Description 76 </p> 77 </th> 78</tr></thead> 79<tbody> 80<tr> 81<td> 82 <p> 83 <code class="computeroutput"><span class="identifier">size</span></code> 84 </p> 85 </td> 86<td> 87 <p> 88 The maximum size of the returned buffer sequence in bytes. If this 89 is greater than or equal to the size of the passed buffer sequence, 90 the result will have the same size as the original buffer sequence. 91 </p> 92 </td> 93</tr> 94<tr> 95<td> 96 <p> 97 <code class="computeroutput"><span class="identifier">buffers</span></code> 98 </p> 99 </td> 100<td> 101 <p> 102 An object whose type meets the requirements of <span class="emphasis"><em>BufferSequence</em></span>. 103 The returned value will maintain a copy of the passed buffers for 104 its lifetime; however, ownership of the underlying memory is not 105 transferred. 106 </p> 107 </td> 108</tr> 109</tbody> 110</table></div> 111<h5> 112<a name="beast.ref.boost__beast__buffers_prefix.h3"></a> 113 <span class="phrase"><a name="beast.ref.boost__beast__buffers_prefix.return_value"></a></span><a class="link" href="boost__beast__buffers_prefix.html#beast.ref.boost__beast__buffers_prefix.return_value">Return 114 Value</a> 115 </h5> 116<p> 117 A constant buffer sequence that represents the prefix of the original buffer 118 sequence. If the original buffer sequence also meets the requirements of 119 <span class="emphasis"><em>MutableBufferSequence</em></span>, then the returned value will 120 also be a mutable buffer sequence. 121 </p> 122</div> 123<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 124<td align="left"></td> 125<td align="right"><div class="copyright-footer">Copyright © 2016-2019 Vinnie 126 Falco<p> 127 Distributed under the Boost Software License, Version 1.0. (See accompanying 128 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 129 </p> 130</div></td> 131</tr></table> 132<hr> 133<div class="spirit-nav"> 134<a accesskey="p" href="boost__beast__buffers_cat.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../ref.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost__beast__buffers_front.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a> 135</div> 136</body> 137</html> 138
