luo980/curl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

curl_easy_escape.md: move historic details to HISTORY

Browse Source 
Closes #14261
This commit is contained in:
Daniel Stenberg 2024-07-23 11:03:15 +02:00
parent 1e769526b4
commit 340ef55d97
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
1 changed files with 13 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/libcurl/curl_easy_escape.md
View File

@ -27,18 +27,14 @@ char *curl_easy_escape(CURL *curl, const char *string, int length);
# DESCRIPTION # DESCRIPTION
This function converts the given input *string* to a URL encoded string This function converts the given input *string* to a URL encoded string and
and returns that as a new allocated string. All input characters that are not returns that as a new allocated string. All input characters that are not a-z,
a-z, A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped" A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped" version
version (**%NN** where **NN** is a two-digit hexadecimal number). (**%NN** where **NN** is a two-digit hexadecimal number).
If *length* is set to 0 (zero), curl_easy_escape(3) uses strlen() on If *length* is set to 0 (zero), curl_easy_escape(3) uses strlen() on the input
the input *string* to find out the size. This function does not accept *string* to find out the size. This function does not accept input strings
input strings longer than **CURL_MAX_INPUT_LENGTH** (8 MB). longer than **CURL_MAX_INPUT_LENGTH** (8 MB).
Since 7.82.0, the **curl** parameter is ignored. Prior to that there was
per-handle character conversion support for some old operating systems such as
TPF, but it was otherwise ignored.
You must curl_free(3) the returned string when you are done with it. You must curl_free(3) the returned string when you are done with it.
@ -83,6 +79,12 @@ int main(void)
} }
~~~ ~~~
# HISTORY
Since 7.82.0, the **curl** parameter is ignored. Prior to that there was
per-handle character conversion support for some old operating systems such as
TPF, but it was otherwise ignored.
# %AVAILABILITY% # %AVAILABILITY%
# RETURN VALUE # RETURN VALUE