1<html> 2<head> 3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 4<title>http::parser::eager (2 of 2 overloads)</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="../eager.html" title="http::parser::eager"> 9<link rel="prev" href="overload1.html" title="http::parser::eager (1 of 2 overloads)"> 10<link rel="next" href="../skip.html" title="http::parser::skip"> 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="overload1.html"><img src="../../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../eager.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="../skip.html"><img src="../../../../../../../../doc/src/images/next.png" alt="Next"></a> 24</div> 25<div class="section"> 26<div class="titlepage"><div><div><h6 class="title"> 27<a name="beast.ref.boost__beast__http__parser.eager.overload2"></a><a class="link" href="overload2.html" title="http::parser::eager (2 of 2 overloads)">http::parser::eager 28 (2 of 2 overloads)</a> 29</h6></div></div></div> 30<p> 31 (Inherited from <a class="link" href="../../boost__beast__http__basic_parser.html" title="http::basic_parser"><code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">basic_parser</span></code></a>) 32 </p> 33<p> 34 Set the eager parse option. 35 </p> 36<h7><a name="beast.ref.boost__beast__http__parser.eager.overload2.h0"></a> 37 <span class="phrase"><a name="beast.ref.boost__beast__http__parser.eager.overload2.synopsis"></a></span><a class="link" href="overload2.html#beast.ref.boost__beast__http__parser.eager.overload2.synopsis">Synopsis</a> 38 </h7><pre class="programlisting"><span class="keyword">void</span> 39<span class="identifier">eager</span><span class="special">(</span> 40 <span class="keyword">bool</span> <span class="identifier">v</span><span class="special">);</span> 41</pre> 42<h7><a name="beast.ref.boost__beast__http__parser.eager.overload2.h1"></a> 43 <span class="phrase"><a name="beast.ref.boost__beast__http__parser.eager.overload2.description"></a></span><a class="link" href="overload2.html#beast.ref.boost__beast__http__parser.eager.overload2.description">Description</a> 44 </h7><p> 45 Normally the parser returns after successfully parsing a structured element 46 (header, chunk header, or chunk body) even if there are octets remaining 47 in the input. This is necessary when attempting to parse the header first, 48 or when the caller wants to inspect information which may be invalidated 49 by subsequent parsing, such as a chunk extension. The <code class="computeroutput"><span class="identifier">eager</span></code> 50 option controls whether the parser keeps going after parsing structured 51 element if there are octets remaining in the buffer and no error occurs. 52 This option is automatically set or cleared during certain stream operations 53 to improve performance with no change in functionality. The default setting 54 is <code class="computeroutput"><span class="keyword">false</span></code>. 55 </p> 56<h7><a name="beast.ref.boost__beast__http__parser.eager.overload2.h2"></a> 57 <span class="phrase"><a name="beast.ref.boost__beast__http__parser.eager.overload2.parameters"></a></span><a class="link" href="overload2.html#beast.ref.boost__beast__http__parser.eager.overload2.parameters">Parameters</a> 58 </h7><div class="informaltable"><table class="table"> 59<colgroup> 60<col> 61<col> 62</colgroup> 63<thead><tr> 64<th> 65 <p> 66 Name 67 </p> 68 </th> 69<th> 70 <p> 71 Description 72 </p> 73 </th> 74</tr></thead> 75<tbody><tr> 76<td> 77 <p> 78 <code class="computeroutput"><span class="identifier">v</span></code> 79 </p> 80 </td> 81<td> 82 <p> 83 <code class="computeroutput"><span class="keyword">true</span></code> to set the 84 eager parse option or <code class="computeroutput"><span class="keyword">false</span></code> 85 to disable it. 86 </p> 87 </td> 88</tr></tbody> 89</table></div> 90</div> 91<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 92<td align="left"></td> 93<td align="right"><div class="copyright-footer">Copyright © 2016-2019 Vinnie 94 Falco<p> 95 Distributed under the Boost Software License, Version 1.0. (See accompanying 96 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>) 97 </p> 98</div></td> 99</tr></table> 100<hr> 101<div class="spirit-nav"> 102<a accesskey="p" href="overload1.html"><img src="../../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../eager.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="../skip.html"><img src="../../../../../../../../doc/src/images/next.png" alt="Next"></a> 103</div> 104</body> 105</html> 106