curlescape(3)                  libcurl Manual                  curlescape(3)



NAME
       curlescape - URL encodes the given string

SYNOPSIS
       ##include <>

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

DESCRIPTION
       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.

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

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



libcurl 7.9                      6 March 2002                   curlescape(3)