**************************************************************************
* _ _ ____ _
* Project ___| | | | _ \| |
* / __| | | | |_) | |
* | (__| |_| | _ <| |___
* \___|\___/|_| \_\_____|
*
* Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
*
* This software is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms
* are also available at https://curl.haxx.se/docs/copyright.html.
*
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
* copies of the Software, and permit persons to whom the Software is
* furnished to do so, under the terms of the COPYING file.
*
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
* KIND, either express or implied.
*
**************************************************************************

curl_easy_escape - URL encodes the given string #include <curl/curl.h> "char *curl_easy_escape( CURL *" curl ", const char *" string ", int "length " );" 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. 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. Added in 7.15.4 and replaces the old curl_escape(3) function. A pointer to a zero terminated string or NULL if it failed.

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);
 }
}

curl_easy_unescape "(3), " curl_free "(3), " RFC 3986