boost::urls::pct_encoded_rule

Rule for a string with percent‐encoded escapes

Synopsis

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.

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 ) );
pct-encoded   = "%" HEXDIG HEXDIG

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