<pclass="level0">This function converts the given URL encoded input string to a "plain string" and returns that in an allocated memory area. All input characters that are URL encoded (%XX where XX is a two-digit hexadecimal number) are converted to their binary versions.
<pclass="level0">If the <spanClass="bold">length</span> argument is set to 0 (zero), <aclass="emphasis"href="./curl_easy_unescape.html">curl_easy_unescape(3)</a> will use strlen() on the input <spanClass="emphasis">url</span> string to find out the size.
<pclass="level0">If <spanClass="bold">outlength</span> is non-NULL, the function will write the length of the returned string in the integer it points to. This allows an escaped string containing %00 to still get used properly after unescaping.
<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_unescape.html">curl_unescape(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>