1 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 2 SPDX-License-Identifier: curl 3 Long: data-urlencode 4 Arg: <data> 5 Help: HTTP POST data URL encoded 6 Protocols: HTTP 7 See-also: data data-raw 8 Added: 7.18.0 9 Category: http post upload 10 Example: --data-urlencode name=val $URL 11 Example: --data-urlencode =encodethis $URL 12 Example: --data-urlencode name@file $URL 13 Example: --data-urlencode @fileonly $URL 14 Multi: append 15 --- 16 This posts data, similar to the other --data options with the exception 17 that this performs URL-encoding. 18 19 To be CGI-compliant, the <data> part should begin with a *name* followed 20 by a separator and a content specification. The <data> part can be passed to 21 curl using one of the following syntaxes: 22 .RS 23 .IP "content" 24 This makes curl URL-encode the content and pass that on. Just be careful 25 so that the content does not contain any = or @ symbols, as that makes 26 the syntax match one of the other cases below! 27 .IP "=content" 28 This makes curl URL-encode the content and pass that on. The preceding = 29 symbol is not included in the data. 30 .IP "name=content" 31 This makes curl URL-encode the content part and pass that on. Note that 32 the name part is expected to be URL-encoded already. 33 .IP "@filename" 34 This makes curl load data from the given file (including any newlines), 35 URL-encode that data and pass it on in the POST. 36 .IP "name@filename" 37 This makes curl load data from the given file (including any newlines), 38 URL-encode that data and pass it on in the POST. The name part gets an equal 39 sign appended, resulting in *name=urlencoded-file-content*. Note that the 40 name is expected to be URL-encoded already. 41 .RE 42 .IP 43