boost::urls::encoded_size

Return the buffer size needed for percent‐encoding

Synopsis

Declared in <boost/url/encode.hpp>

template<grammar::CharSet CS>
std::size_t
encoded_size(
    core::string_view s,
    CS const& unreserved,
    encoding_opts opt = {}) noexcept;

Description

This function returns the exact number of bytes necessary to store the result of applying percent‐encoding to the string using the given options and character set. No encoding is actually performed.

Example

assert( encoded_size( "My Stuff", pchars ) == 10 );

Exception Safety

Throws nothing.

Return Value

The number of bytes needed, excluding any null terminator.

Parameters

Name

Description

s

The string to measure.

unreserved

The set of characters that is not percent‐encoded.

opt

The options for encoding. If this parameter is omitted, the default options are be used.

See Also