• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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