• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 Long: data-urlencode
2 Arg: <data>
3 Help: HTTP POST data url encoded
4 Protocols: HTTP
5 See-also: data data-raw
6 Added: 7.18.0
7 Category: http post upload
8 ---
9 This posts data, similar to the other --data options with the exception
10 that this performs URL-encoding.
11 
12 To be CGI-compliant, the <data> part should begin with a \fIname\fP followed
13 by a separator and a content specification. The <data> part can be passed to
14 curl using one of the following syntaxes:
15 .RS
16 .IP "content"
17 This will make curl URL-encode the content and pass that on. Just be careful
18 so that the content doesn't contain any = or @ symbols, as that will then make
19 the syntax match one of the other cases below!
20 .IP "=content"
21 This will make curl URL-encode the content and pass that on. The preceding =
22 symbol is not included in the data.
23 .IP "name=content"
24 This will make curl URL-encode the content part and pass that on. Note that
25 the name part is expected to be URL-encoded already.
26 .IP "@filename"
27 This will make curl load data from the given file (including any newlines),
28 URL-encode that data and pass it on in the POST.
29 .IP "name@filename"
30 This will make curl load data from the given file (including any newlines),
31 URL-encode that data and pass it on in the POST. The name part gets an equal
32 sign appended, resulting in \fIname=urlencoded-file-content\fP. Note that the
33 name is expected to be URL-encoded already.
34 .RE
35