curleasyescape(3) libcurl Manual curleasyescape(3)

NAME
       curleasyescape - URL encodes the given string

SYNOPSIS
       ##iinncclluuddee <>

       cchhaarr **ccuurrlleeaassyyeessccaappee(( CCUURRLL **curl,, cchhaarr **url,, iinntt 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 converted to their "URL escaped" version
       (%NN where NN is a two-digit hexadecimal number).

       If the lleennggtthh argument is set  to  0  (zero),  curleasyescape()  uses
       strlen() on the input uurrll 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() function.

RREETTUURRNN VVAALLUUEE
       A pointer to a zero terminated string or NULL if it failed.

SEE ALSO
       ccuurrlleeaassyyuunneessccaappee(3), ccuurrllffrreeee(3), RRFFCC2396



libcurl 7.15.4                   7 April 2006              curleasyescape(3)