Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit b5c99c1c90.
PrevUpHomeNext

http::error

Error codes returned from HTTP algorithms and operations.

Synopsis

Defined in header <boost/beast/http/error.hpp>

enum error
Values

Name

Description

end_of_stream

The end of the stream was reached.

This error is returned when attempting to read HTTP data, and the stream returns the error net::error::eof before any octets corresponding to a new HTTP message have been received.

partial_message

The incoming message is incomplete.

This happens when the end of stream is reached during parsing and some octets have been received, but not the entire message.

need_more

Additional buffers are required.

This error is returned during parsing when additional octets are needed. The caller should append more data to the existing buffer and retry the parse operaetion.

unexpected_body

An unexpected body was encountered during parsing.

This error is returned when attempting to parse body octets into a message container which has the @ref empty_body body type.

@see empty_body

need_buffer

Additional buffers are required.

This error is returned under the following conditions:

@li During serialization when using @ref buffer_body. The caller should update the body to point to a new buffer or indicate that there are no more octets in the body.

@li During parsing when using @ref buffer_body. The caller should update the body to point to a new storage area to receive additional body octets.

end_of_chunk

The end of a chunk was reached.

buffer_overflow

Buffer maximum exceeded.

This error is returned when reading HTTP content into a dynamic buffer, and the operation would exceed the maximum size of the buffer.

header_limit

Header limit exceeded.

The parser detected an incoming message header which exceeded a configured limit.

body_limit

Body limit exceeded.

The parser detected an incoming message body which exceeded a configured limit.

bad_alloc

A memory allocation failed.

When basic_fields throws std::bad_alloc, it is converted into this error by @ref parser.

bad_line_ending

The line ending was malformed.

bad_method

The method is invalid.

bad_target

The request-target is invalid.

bad_version

The HTTP-version is invalid.

bad_status

The status-code is invalid.

bad_reason

The reason-phrase is invalid.

bad_field

The field name is invalid.

bad_value

The field value is invalid.

bad_content_length

The Content-Length is invalid.

bad_transfer_encoding

The Transfer-Encoding is invalid.

bad_chunk

The chunk syntax is invalid.

bad_chunk_extension

The chunk extension is invalid.

bad_obs_fold

An obs-fold exceeded an internal limit.

stale_parser

The parser is stale.

This happens when attempting to re-use a parser that has already completed parsing a message. Programs must construct a new parser for each message. This can be easily done by storing the parser in an boost or std::optional container.

short_read

The message body is shorter than expected.

This error is returned by @ref file_body when an unexpected unexpected end-of-file condition is encountered while trying to read from the file.

Description

PrevUpHomeNext