<pclass="level0">This function converts the given input string to an URL encoded string and returns that as a new allocated string. All input characters that are not a-z, A-Z or 0-9 are converted to their "URL escaped" version (%NN where NN is a two-digit hexadecimal number).
<pclass="level0">If the <spanClass="bold">length</span> argument is set to 0 (zero), <aclass="emphasis"href="./curl_easy_escape.html">curl_easy_escape(3)</a> uses strlen() on the input <spanClass="bold">url</span> to find out the size.
<pclass="level0">You must <aclass="emphasis"href="./curl_free.html">curl_free(3)</a> the returned string when you're done with it. <aname="AVAILABILITY"></a><h2class="nroffsh">AVAILABILITY</h2>
<pclass="level0">Added in 7.15.4 and replaces the old <aclass="emphasis"href="./curl_escape.html">curl_escape(3)</a> function. <aname="RETURN"></a><h2class="nroffsh">RETURN VALUE</h2>
<pclass="level0">A pointer to a zero terminated string or NULL if it failed. <aname="SEE"></a><h2class="nroffsh">SEE ALSO</h2>