grammar::tuple_rule

Match a series of rules in order.

Synopsis

Defined in header <boost/url/grammar/tuple_rule.hpp>

template<
    class... Rules>
constexpr implementation-defined
tuple_rule(
    Rules... rn);

This matches a series of rules in the order specified. Upon success the input is adjusted to point to the first unconsumed character. There is no implicit specification of linear white space between each rule.

Value Type

using value_type = __see_below__;

The sequence rule usually returns a std::tuple containing the the value_type of each corresponding rule in the sequence, except that void values are removed. However, if there is exactly one non-void value type T, then the sequence rule returns system::result<T> instead of system::result<tuple<...>>.

Example

Rules are used with the function parse.

system::result< std::tuple< unsigned char, unsigned char, unsigned char, unsigned char > > rv =
    parse( "192.168.0.1" ,
        tuple_rule(
            dec_octet_rule,
            squelch( delim_rule( '.' ) ),
            dec_octet_rule,
            squelch( delim_rule( '.' ) ),
            dec_octet_rule,
            squelch( delim_rule( '.' ) ),
            dec_octet_rule ) );