curl_unescape(3)

curl_unescape(3)         libcurl Manual          curl_unescape(3)

NAME

     curl_unescape - URL decodes the given string

SYNOPSIS

     #include <curl/curl.h>

     char *curl_unescape( 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 allo-
     cated string. All input characters that are URL encoded (%XX
     where  XX  is  a  two-digit hexadecimal number) will be con-
     verted to their plain text versions.

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

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

RETURN VALUE

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

SEE ALSO

     curl_escape(3), curl_free(3), RFC 2396

libcurl 7.7        Last change: 22 March 2001                   1