curl_easy_escape(3)       libcurl Manual      curl_easy_escape(3)



NAME
       curl_easy_escape - URL encodes the given string

SYNOPSIS
       #include 

       char  *curl_easy_escape( CURL *curl, char *url, int length
       );

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

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

       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_escape() func-
       tion.

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

SEE ALSO
       curl_easy_unescape(3), curl_free(3), RFC2396



libcurl 7.15.4             7 April 2006       curl_easy_escape(3)