basic_parser::fail

Indicate a parsing failure.

Synopsis

void
fail(
    system::error_code ec);

Description

This changes the state of the parser to indicate that the parse has failed. A parser implementation can use this to fail the parser if needed due to external inputs.

Remarks

If !ec, the stored error code is unspecified.

Complexity

Constant.

Exception Safety

No-throw guarantee.

Parameters

Name	Description
`ec`	The error code to set. If the code does not indicate failure, an implementation-defined error code that indicates failure will be stored instead.