Rule for a string with percent‐encoded escapes

Synopsis

Declared in <boost/url/rfc/pct_encoded_rule.hpp>

template<grammar::CharSet CS>
constexpr
/* implementation-defined */
pct_encoded_rule(CS const& cs) noexcept;

Description

This function returns a rule which matches a percent‐encoded string, permitting characters in the string which are also in the specified character set to be used unescaped.

Value Type

using value_type = pct_string_view;

Example

Rules are used with the function grammar::parse.

//  pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"

system::result< pct_string_view > rv = grammar::parse( "Program%20Files", pct_encoded_rule( pchars ) );

BNF

pct-encoded   = "%" HEXDIG HEXDIG

Specification

Return Value

A rule object.

Parameters

Name

Description

cs

The character set indicating which characters are allowed without escapes. Any character which is not in this set must be escaped, or else parsing returns an error.

See Also

grammar::parse, pchars, pct_string_view.

Created with MrDocs