"Fossies" - the Fresh Open Source Software Archive

Member "curl-7.66.0/docs/libcurl/curl_easy_escape.3" (11 Sep 2019, 2737 Bytes) of package /linux/www/curl-7.66.0.tar.xz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the latest Fossies "Diffs" side-by-side code changes report for "curl_easy_escape.3": 7.65.3_vs_7.66.0.

curl_easy_escape

NAME
SYNOPSIS
DESCRIPTION
ENCODING
AVAILABILITY
RETURN VALUE
EXAMPLE
SEE ALSO

NAME

curl_easy_escape - URL encodes the given string

SYNOPSIS

#include <curl/curl.h>

char *curl_easy_escape( CURL *curl, const char *string , int length );

DESCRIPTION

This function converts the given input string to a URL encoded string and returns that as a new allocated string. All input characters that are not a-z, A-Z, 0-9, ’-’, ’.’, ’_’ or ’~’ are converted to their "URL escaped" version (%NN where NN is a two-digit hexadecimal number).

If length is set to 0 (zero), curl_easy_escape(3) uses strlen() on the input string to find out the size.

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

ENCODING

libcurl is typically not aware of, nor does it care about, character encodings. curl_easy_escape(3) encodes the data byte-by-byte into the URL encoded version without knowledge or care for what particular character encoding the application or the receiving server may assume that the data uses.

The caller of curl_easy_escape(3) must make sure that the data passed in to the function is encoded correctly.

AVAILABILITY

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

RETURN VALUE

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

EXAMPLE

CURL *curl = curl_easy_init();
if(curl) {
char *output = curl_easy_escape(curl, "data to convert", 15);
if(output) {
printf("Encoded: %s\n", output);
curl_free(output);
}
}

SEE ALSO

curl_easy_unescape(3), curl_free(3), RFC3986