End of Input Parser (eoi)

| Home | Libraries | People | FAQ | More

##### End of Input Parser (`eoi`)

###### Description

The `eoi` parser matches the end of input (returns a successful match with 0 length when the input is exhausted)

###### Header

    // forwards to <boost/spirit/home/qi/auxiliary/eoi.hpp>
    #include <boost/spirit/include/qi_eoi.hpp>

Also, see Include Structure.

###### Namespace

Name
`boost::spirit::eoi // alias: boost::spirit::qi::eoi`

###### Model of

> `PrimitiveParser`

###### Expression Semantics

Semantics of an expression is defined only where it differs from, or is not defined in `PrimitiveParser`.

Expression | Semantics
--- | ---
`eoi` | Create a parser that matches the end of input.

###### Attributes

Expression | Attribute
--- | ---
`eoi` | `unused`

###### Complexity

> O(1)

###### Example

| Note
The test harness for the example(s) below is presented in the Basics Examples section.

Some using declarations:

    using boost::spirit::qi::eoi;

Using `eoi`:

    test_parser("", eoi);