Initializing help system before first use

httpput

httpput


Purpose
Perform an HTTP PUT request.
Synopsis
function httpput(url:string|text, data:string, result:string):integer
function httpput(url:string|text, data:string, result:string, xhdr:string|text):integer
Arguments
url 
URL to process
data 
Data file to be sent to the server
result 
File to store the result of the request
xhdr 
Additional headers to add to the request
Return value
HTTP status of the request ( e.g. 200 for success, see HTTP standard specifications for a full list; value 999 indicates that an I/O error occurred during the operation) or the request number (≥1000) if asynchronous mode is active
Further information
1. The function returns after the request has been processed when synchronous mode is active (see http_async). Otherwise, using asynchronous mode, the function returns immediately after having sent the request and the model is notified about the completion of the operation by an event of class EVENT_HTTPEND. In this mode the result file result must be a physical file (although drivers "tmp:" and "null:" can still be used).
2. The parameter xhdr is typically used when the data type has to be specified. For instance, when the data sent is URL-encoded it may be necessary to use "Content-Type: application/x-www-form-urlencoded" as the value for xhdr in order to indicate to the server how to decode and process this data.
Related topics
Module