curl_unescape DEPRECATED

Syntax

#include <curl/curl.h>

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

Parameters

url Pointer to a URL-encoded string.
length Length of the string to be converted.

Return Values

Pointer to a newly allocated string.

Description

Obsolete function. Use curl_easy_unescape instead.

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

If the length argument is set to 0, curl_unescape will use strlen on the input url string to discover the size.

Use curl_free on the returned string when finished with it.

Do Not Call From

Deprecated Do not call this function in new code.

See Also

HTTP Client Library (libcurl)
libcurl API Functions
libcurl Error Codes
curl_easy_escape
curl_easy_unescape
curl_free

Revision History

2013/09/18 Conversion
2013/05/08 Automated cleanup pass.
2012/05/04 Initial version.


CONFIDENTIAL