range

A forward range of parsed elements

Synopsis

template< class T> class range ;

Declared in file <boost/url/grammar/range_rule.hpp> at line 60

Types

Name Description
iterator

A constant, forward iterator to elements of the range

Types

Name Description
value_type

The type of each element of the range

reference

The type of each element of the range

const_reference

The type of each element of the range

pointer

Provided for compatibility, unused

size_type

The type used to represent unsigned integers

difference_type

The type used to represent signed integers

const_iterator

A constant, forward iterator to elements of the range

Member Functions

Name Description
~range

Destructor

range

Constructor

range

Constructor

range

Constructor

operator=

Constructor

operator=

Assignment

begin

Return an iterator to the beginning

end

Return an iterator to the end

empty

Return true if the range is empty

size

Return the number of elements in the range

string

Return the matching part of the string

Description

Objects of this type are forward ranges returned when parsing using the range_rule. Iteration is performed by re-parsing the underlying character buffer. Ownership of the buffer is not transferred; the caller is responsible for ensuring that the lifetime of the buffer extends until it is no longer referenced by the range.

NOTE

The implementation may use temporary, recycled storage for type-erasure. Objects of type `range` are intended to be used ephemerally. That is, for short durations such as within a function scope. If it is necessary to store the range for a long period of time or with static storage duration, it is necessary to copy the contents to an object of a different type.