| --- | |
| sidebar_label: urlencode | |
| description: The urlencode function applies URL encoding to a given string. | |
| --- | |
| # `urlencode` Function | |
| `urlencode` applies URL encoding to a given string. | |
| This function identifies characters in the given string that would have a | |
| special meaning when included as a query string argument in a URL and | |
| escapes them using | |
| [RFC 3986 "percent encoding"](https://tools.ietf.org/html/rfc3986#section-2.1). | |
| The exact set of characters escaped may change over time, but the result | |
| is guaranteed to be interpolatable into a query string argument without | |
| inadvertently introducing additional delimiters. | |
| If the given string contains non-ASCII characters, these are first encoded as | |
| UTF-8 and then percent encoding is applied separately to each UTF-8 byte. | |
| ## Examples | |
| ``` | |
| > urlencode("Hello World!") | |
| Hello+World%21 | |
| > urlencode("☃") | |
| %E2%98%83 | |
| > "http://example.com/search?q=${urlencode("tofu urlencode")}" | |
| http://example.com/search?q=tofu+urlencode | |
| ``` |