mirror of
https://github.com/Xahau/xahaud.git
synced 2025-12-06 17:27:52 +00:00
d8dea963fa
6d5547a Set version to 1.0.0-b34 6fab138 Fix and tidy up CMake build scripts: ccefa54 Set version to 1.0.0-b33 32afe41 Set internal state correctly when writing frames: fe3e20b Add write_frames unit test 578dcd0 Add decorator unit test aaa3733 Use fwrite return value in file_body df66165 Require Visual Studio 2015 Update 3 or later b8e5a21 Set version to 1.0.0-b32 ffb1758 Update CMake scripts for finding packages: b893749 Remove http Writer suspend and resume feature (API Change): 27864fb Add io_service completion invariants tests eba05a7 Set version to 1.0.0-b31 484bcef Fix badge markdown in README.md 5663bea Add missing dynabuf_readstream member 0d7a551 Tidy up build settings 0fd4030 Move the handler, don't copy it git-subtree-dir: src/beast git-subtree-split: 6d5547a32c50ec95832c4779311502555ab0ee1f
62 lines
1.9 KiB
Plaintext
62 lines
1.9 KiB
Plaintext
[/
|
|
Copyright (c) 2013-2017 Vinnie Falco (vinnie dot falco at gmail dot com)
|
|
|
|
Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
]
|
|
|
|
[section:Parser Parser requirements]
|
|
|
|
A [*Parser] is used to deserialize objects from
|
|
[link beast.ref.streams streams]. Objects of this type are used with
|
|
[link beast.ref.http__parse http::parse] and
|
|
[link beast.ref.http__async_parse http::async_parse]. The definition of
|
|
an object, and the predicate defining when the parse is complete, are
|
|
determined by the implementation.
|
|
|
|
In this table:
|
|
|
|
* `X` denotes a type meeting the requirements of [*Parser].
|
|
|
|
* `a` denotes a value of type `X`.
|
|
|
|
* `b` is a value meeting the requirements of __ConstBufferSequence__.
|
|
|
|
* `ec` is a value of type [link beast.ref.error_code `error_code&`].
|
|
|
|
[table Parser requirements
|
|
[[operation] [type] [semantics, pre/post-conditions]]
|
|
[
|
|
[`a.complete()`]
|
|
[`bool`]
|
|
[
|
|
Returns `true` when parsing is complete.
|
|
]
|
|
]
|
|
[
|
|
[`a.write(b, ec)`]
|
|
[`std::size_t`]
|
|
[
|
|
Sequentially parses the octets in the specified input buffer sequence
|
|
until an error occurs, the end of the buffer is reached, or parsing is
|
|
complete. Upon success, this function returns the number of bytes used
|
|
from the input. If an error occurs, `ec` is set to the error code and
|
|
parsing stops.
|
|
]
|
|
]
|
|
[
|
|
[`a.write_eof(ec)`]
|
|
[`void`]
|
|
[
|
|
Indicates to the parser that no more octets will be available.
|
|
Typically this function is called when the end of stream is reached.
|
|
For example, if a call to `boost::asio::ip::tcp::socket::read_some`
|
|
generates a `boost::asio::error::eof` error. Some objects, such as
|
|
certain HTTP/1 messages, determine the end of the message body by
|
|
an end of file marker or closing of the connection.
|
|
]
|
|
]
|
|
]
|
|
|
|
[endsect]
|