curlunescape(3)                libcurl Manual                curlunescape(3)



NAME
       curlunescape - URL decodes the given string

SYNOPSIS
       ##include <>

       char **curlunescape( char **url,, int length );;

DESCRIPTION
       This  function  will  convert  the  given URL encoded input string to a
       "plain string" and return that as a new  allocated  string.  All  input
       characters  that are URL encoded (%X where X is a two-digit hexadeci-
       mal number) will be converted to their plain text versions.

       If the 'length' argument is set to 0, curlunescape() will use strlen()
       on the input 'url' string to find out the size.

       You must curlfree() the returned string when you're done with it.

RETURN VALUE
       A pointer to a zero terminated string or NUL if it failed.

SEE ALSO
       curlescape(3), curlfree(3), RFC 2396



libcurl 7.7                      22 March 2001                curlunescape(3)