Meet us at at Real World in Orlando, Florida.

All functions   Mac OS X   Windows   Crossplatform   Components   Guides  
New in version: 2.0   2.1   2.2   2.3   2.4   2.5   2.6   2.7   2.8  

CURL.SetOptionUpload

Component: CURL
Version: 2.5
Mac OS X: Works
Windows: Works

MBS( "CURL.SetOptionUpload"; handle; value )

Parameters

Parameter Description Example value
Handle The CURL session handle. $curl
Value Whether to do an upload. 1

Result

Returns "OK" on success.

Description

Sets this transfer to be an upload.
A parameter set to 1 tells the library to prepare for an upload. With the CURL.SetInput functions you can define the upload data. If the protocol is HTTP, uploading means using the PUT request unless you tell curl otherwise.

Using PUT with HTTP 1.1 implies the use of a "Expect: 100-continue" header. You can disable this header with CURL.SetOptionHTTPHeader as usual.

If you use PUT to a HTTP 1.1 server, you can upload data without knowing the size before starting the transfer if you use chunked encoding. You enable this by adding a header like "Transfer-Encoding: chunked" with CURL.SetOptionHTTPHeader. With HTTP 1.0 or without chunked transfer, you must specify the size.

Feedback: Report problem or ask question.




Links
MBS Realbasic tutorial videos - Pfarrgemeinde Ministranten Nickenich