Description

Библиотека предоставляет пару Standard IO Manipulators Позволяет интегрировать Spirit.Qi входные пароходы со стандартными потоками ввода. Эти манипуляторы парсера имеют две формы. Первая форма, match, работает на уровне персонажа. Второй phrase_match работает на уровне фразы и требует прогулочного парсера. Обе версии могут принимать атрибуты путем ссылки, которая будет удерживать парсированные значения на успешном парсе.

Header

// forwards to <boost/spirit/home/qi/stream/match_manip.hpp>
#include <boost/spirit/include/qi_match.hpp>

Для вариатических атрибутов:

// forwards to <boost/spirit/home/qi/stream/match_manip_attr.hpp>
#include <boost/spirit/include/qi_match_attr.hpp>

Версия атрибутов API позволяет передавать один или несколько атрибутов в манипуляторы. Манипуляторы, принимающие два или более атрибутов, могут использоваться, когда выражение парсера является только Sequence. В этом случае каждый из переданных атрибутов должен соответствовать соответствующей части последовательности.

Для API функции вывода правильного (сопоставимого) типа парсера из заданного типа атрибута:

// forwards to <boost/spirit/home/qi/match_auto.hpp>
#include <boost/spirit/include/qi_match_auto.hpp>

Также см. Include Structure.

Namespace

Synopsis

namespace boost { namespace spirit { namespace qi
{
    template <typename Expr>
    inline <unspecified>
    match(
        Expr const& xpr);
    template <typename Expr
      , typename Attr1, typename Attr2, ..., typename AttrN>
    inline <unspecified>
    match(
        Expr const& xpr
      , Attr1& attr1, Attr2& attr2, ..., AttrN& attrN);
    template <typename Expr, typename Skipper>
    inline <unspecified>
    phrase_match(
        Expr const& expr
      , Skipper const& s
      , BOOST_SCOPED_ENUM(skip_flag) post_skip = skip_flag::postskip);
    template <typename Expr, typename Skipper
      , typename Attr1, typename Attr2, ..., typename AttrN>
    inline <unspecified>
    phrase_match(
        Expr const& expr
      , Skipper const& s
      , Attr1& attr1, Attr2& attr2, ..., AttrN& attrN);
    template <typename Expr, typename Skipper
      , typename Attr1, typename Attr2, ..., typename AttrN>
    inline <unspecified>
    phrase_match(
        Expr const& expr
      , Skipper const& s
      , BOOST_SCOPED_ENUM(skip_flag) post_skip
      , Attr1& attr1, Attr2& attr2, ..., AttrN& attrN);
}}}

Spirit.Qi Парсер API функции, основанные на автоматическом создании парсерного типа:

namespace boost { namespace spirit { namespace qi
{
    template <typename Attr>
    inline <unspecified>
    match(
        Attr& attr);
    template <typename Attr, typename Skipper>
    inline <unspecified>
    phrase_match(
        Attr& attr
      , Skipper const& s
      , BOOST_SCOPED_ENUM(skip_flag) post_skip = skip_flag::postskip);
}}}

Все вышеперечисленные функции возвращают стандартный экземпляр манипулятора потока IO (см. Manipulators), который при перемещении из потока ввода приведет к выравниванию входного потока с использованием встроенного выражения Spirit.Qi. Любая ошибка (или неудачный парс), возникающая во время вызова Spirit.Qi, будет отражена в флаге состояния потоков (std::ios_base::failbit будет установлен).

Максимальное количество аргументов ограничено препроцессорной константой SPIRIT_ARGUMENTS_LIMIT. Эта константа по умолчанию для значения, определенного препроцессорной константой PHOENIX_LIMIT (что, в свою очередь, не соответствует 10).

	Note
	Вариатические манипуляторы с двумя или более атрибутами внутренне объединяют ссылки на все переданные атрибуты в fusion::vector и передают это в качестве объединенного атрибута соответствующему манипулятору, принимающему один атрибут.

The phrase_match manipulators not taking an explicit skip_flag as one of their arguments call the passedper after a successful match of the parser expression. Это может быть ингибировано с помощью других версий этого манипулятора во время прохождения skip_flag::dont_postskip в соответствующий аргумент.

Template parameters