libcurl Manual                                     curlescape(3)



NAME
     curlescape - URL encodes the given string

SYNOPSIS
     #include 

     char *curlescape( char *url, int length );

DESCRIPTION
     Obsolete function. Use curleasyescape(3) instead!

     This function will convert the given input string to an  URL
     encoded  string  and  return that as a new allocated string.
     All input characters that are not a-z, A-Z or  0-9  will  be
     converted  to their "URL escaped" version (%N where N is a
     two-digit hexadecimal number).

     If the 'length' argument is set to 0, curlescape() will use
     strlen() on the input 'url' string to find out the size.

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

AVAILABILITY
     Since 7.15.4, curleasyescape(3) should be used. This func-
     tion will be removed in a future release.

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

SEE ALSO
     curlunescape(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.9         Last change: 6 March 2002                   1