libcurl Manual                                curleasyescape(3)



NAME
     curleasyescape - URL encodes the given string

SYNOPSIS
     #include 

     char *curleasyescape( 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 (%N where N is a
     two-digit hexadecimal number).

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

     You must curlfree(3) the returned string when  you're  done
     with it.

AVAILABILITY
     Added in 7.15.4 and replaces the  old  curlescape(3)  func-
     tion.

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

SEE ALSO
     curleasyunescape(3), curlfree(3), RFC2396

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWcurl       
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for C-URL is available on http:/opensolaris.org.









libcurl 7.15.4      Last change: 7 April 2006                   1