This manual page is for Mac OS X version 10.6

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


curl_easy_unescape(3)                          libcurl Manual                          curl_easy_unescape(3)



NAME
       curl_easy_unescape - URL decodes the given string

SYNOPSIS
       #include <curl/curl.h>

       char *curl_easy_unescape( CURL *curl, char *url, int inlength , int *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 characters that are URL encoded (%XX where XX is a  two-digit  hexa-decimal hexadecimal
       decimal number) are converted to their binary versions.

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

       If outlength 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 curl_free(3) the returned string when you're done with it.

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

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

SEE ALSO
       curl_easy_escape(3), curl_free(3), RFC 2396



libcurl 7.15.4                                  7 April 2006                           curl_easy_unescape(3)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.