~ubuntu-branches/ubuntu/warty/curl/warty-security

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_escape.3

  • Committer: Bazaar Package Importer
  • Author(s): Domenico Andreoli
  • Date: 2004-06-04 19:09:25 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20040604190925-wy048bp31320r2z6
Tags: 7.12.0.is.7.11.2-1
* Reverted to version 7.11.2 (closes: #252348).
* Disabled support for libidn (closes: #252367). This is to leave
  curl in unstable as much similar as possible to the one in testing.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" You can view this file with:
2
 
.\" nroff -man [file]
3
 
.\" $Id: curl_escape.3,v 1.2 2002/03/06 07:44:49 bagder Exp $
4
 
.\"
5
 
.TH curl_escape 3 "6 March 2002" "libcurl 7.9" "libcurl Manual"
6
 
.SH NAME
7
 
curl_escape - URL encodes the given string
8
 
.SH SYNOPSIS
9
 
.B #include <curl/curl.h>
10
 
.sp
11
 
.BI "char *curl_escape( char *" url ", int "length " );"
12
 
.ad
13
 
.SH DESCRIPTION
14
 
This function will convert the given input string to an URL encoded string and
15
 
return that as a new allocated string. All input characters that are not a-z,
16
 
A-Z or 0-9 will be converted to their "URL escaped" version (%NN where NN is a
17
 
two-digit hexadecimal number).
18
 
 
19
 
If the 'length' argument is set to 0, curl_escape() will use strlen() on the
20
 
input 'url' string to find out the size.
21
 
 
22
 
You must free() the returned string when you're done with it.
23
 
.SH RETURN VALUE
24
 
A pointer to a zero terminated string or NULL if it failed.
25
 
.SH "SEE ALSO"
26
 
.I curl_unescape(), RFC 2396
 
1
.\" You can view this file with:
 
2
.\" nroff -man [file]
 
3
.\" $Id: curl_escape.3,v 1.5 2004/02/27 15:34:06 bagder Exp $
 
4
.\"
 
5
.TH curl_escape 3 "6 March 2002" "libcurl 7.9" "libcurl Manual"
 
6
.SH NAME
 
7
curl_escape - URL encodes the given string
 
8
.SH SYNOPSIS
 
9
.B #include <curl/curl.h>
 
10
.sp
 
11
.BI "char *curl_escape( char *" url ", int "length " );"
 
12
.ad
 
13
.SH DESCRIPTION
 
14
This function will convert the given input string to an URL encoded string and
 
15
return that as a new allocated string. All input characters that are not a-z,
 
16
A-Z or 0-9 will be converted to their "URL escaped" version (%NN where NN is a
 
17
two-digit hexadecimal number).
 
18
 
 
19
If the 'length' argument is set to 0, curl_escape() will use strlen() on the
 
20
input 'url' string to find out the size.
 
21
 
 
22
You must curl_free() the returned string when you're done with it.
 
23
.SH RETURN VALUE
 
24
A pointer to a zero terminated string or NULL if it failed.
 
25
.SH "SEE ALSO"
 
26
.BR curl_unescape(3), curl_free(3), RFC 2396