:relfileprefix: ../../
[#9AFE8BBE491369CEC5857C0AF9A53BEFD1CC115C]

= Function encode

pass:v,q[Apply percent-encoding to a string]


== Synopsis

Declared in header `</boost/url/encode.hpp#L118[boost/url/encode.hpp,window=blank_]>`

[source,cpp,subs="verbatim,macros,-callouts"]
----
template<class CharSet>
size_t
encode(
    char* dest,
    size_t size,
    string_view s,
    const CharSet& unreserved,
    xref:boost/urls/encoding_opts.adoc[encoding_opts] opt = = {});
----

== Description

pass:v,q[This function applies percent-encoding] pass:v,q[to the string using the given options and]
pass:v,q[character set. The destination buffer]
pass:v,q[provided by the caller is used to store]
pass:v,q[the result, which may be truncated if]
pass:v,q[there is insufficient space.]

=== Example
[,cpp]
----
char buf[100];
assert( encode( buf, sizeof(buf), "Program Files", pchars ) == 15 );
----

=== Exception Safety
pass:v,q[Throws nothing.]

=== Specification

* link:https://datatracker.ietf.org/doc/html/rfc3986#section-2.1[2.1. Percent-Encoding (rfc3986)]



== Return Value

* `size_t` 


== Parameters

|===
| Name | Type 

| *dest*
| ``

| *size*
| `size_t`

| *s*
| `string_view`

| *unreserved*
| ``

| *opt*
| `encoding_opts`

|===