Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curl_escape(3)		   Library Functions Manual		curl_escape(3)

NAME
       curl_escape - URL encode	a string

SYNOPSIS
       #include	<curl/curl.h>

       char *curl_escape(const char *string, int length);

DESCRIPTION
       Obsolete	function. Use curl_easy_escape(3) instead.

       This  function  converts	the given input	string to a URL	encoded	string
       and return 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 length argument is set to	0,  curl_escape(3)  uses  strlen()  on
       string to find out the size.

       You must	curl_free(3) the returned string when you are done with	it.

PROTOCOLS
       This functionality affects all supported	protocols

EXAMPLE
       int main(void)
       {
	 char *output =	curl_escape("data to convert", 15);
	 if(output) {
	   printf("Encoded: %s\n", output);
	   curl_free(output);
	 }
       }

HISTORY
       Since  7.15.4,  curl_easy_escape(3) should be used. This	function might
       be removed in a future release.

AVAILABILITY
       Added in	curl 7.1

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

SEE ALSO
       curl_free(3), curl_unescape(3)

libcurl				  2025-06-03			curl_escape(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=curl_escape&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help