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