[#boost-urls-grammar-range_rule-02]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/grammar.adoc[grammar]::range_rule
:relfileprefix: ../../../
:mrdocs:

Match a repeating number of elements

== Synopses

Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/grammar/range_rule.hpp#L397[boost/url/grammar/range_rule.hpp]>`

Match a repeating number of elements


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<xref:boost/urls/grammar/Rule.adoc[Rule] R>
constexpr
/* implementation-defined */
xref:boost/urls/grammar/range_rule-00.adoc[range_rule](
    R const& next,
    std::size_t N = 0,
    std::size_t M = std::size_t(‐1)) noexcept;
----

[.small]#xref:boost/urls/grammar/range_rule-00.adoc[_» more..._]#

Match a repeating number of elements


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    xref:boost/urls/grammar/Rule.adoc[Rule] R1,
    xref:boost/urls/grammar/Rule.adoc[Rule] R2>
constexpr
/* implementation-defined */
xref:boost/urls/grammar/range_rule-06.adoc[range_rule](
    R1 const& first,
    R2 const& next,
    std::size_t N = 0,
    std::size_t M = std::size_t(‐1)) noexcept
requires ! std::is_integral<R2>::value;
----

[.small]#xref:boost/urls/grammar/range_rule-06.adoc[_» more..._]#

== Return Value

A rule that matches the range.

== Parameters

[cols=2]
|===
| Name
| Description
| *next*
| The rule to use for matching each element. The range extends until this rule returns an error.
| *N*
| The minimum number of elements for the range to be valid. If omitted, this defaults to zero.
| *M*
| The maximum number of elements for the range to be valid. If omitted, this defaults to unlimited.
| *first*
| The rule to use for matching the first element. If this rule returns an error, the range is empty.
|===

== See Also

xref:boost/urls/grammar/alpha_chars.adoc[`alpha_chars`], xref:boost/urls/grammar/delim_rule-0a.adoc[`delim_rule`], xref:boost/urls/grammar/error.adoc[`error::end_of_range`], xref:boost/urls/grammar/parse-09.adoc[`parse`], xref:boost/urls/grammar/range.adoc[`range`], xref:boost/urls/grammar/tuple_rule.adoc[`tuple_rule`], xref:boost/urls/grammar/squelch.adoc[`squelch`].


[.small]#Created with https://www.mrdocs.com[MrDocs]#