curleasyunescape(3) libcurl Manual curleasyunescape(3)

NAME
       curleasyunescape - URL decodes the given string

SYNOPSIS
       ##iinncclluuddee <>

       cchhaarr  **ccuurrlleeaassyyuunneessccaappee((  CCUURRLL  **curl,,  cchhaarr **url,, iinntt inlength ,, iinntt
       **outlength ));;

DESCRIPTION
       This function converts the given URL encoded input string to  a  "plain
       string" and returns that in an allocated memory area. All input charac-
       ters that are URL encoded (%XX where XX is a two-digit hexadecimal num-
       ber) are converted to their binary versions.

       If  the  lleennggtthh  argument is set to 0 (zero), curleasyunescape() will
       use strlen() on the input url string to find out the size.

       If oouuttlleennggtthh 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.

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

AVAILABILITY       Added in 7.15.4 and replaces the old curlunescape() function.

RREETTUURRNN VVAALLUUEE
       A pointer to a zero terminated string or NULL if it failed.

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



libcurl 7.15.4                   7 April 2006            curleasyunescape(3)