URL - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Connectivity : Web Features : Web Page Access : URL package : URL/Delete

URL

  

Delete

  

delete data residing at a specified URL

 

Calling Sequence

Parameters

Options

Description

Examples

References

Compatibility

Calling Sequence

Delete( url, options )

Parameters

url

-

a string specifying the URL at which the data resides

options

-

options as specified below

Options

• 

cafile=string

  

a certificate file to use when authenticating the server. Maple includes a certificate file containing certificates for the major Certificate Authorities.

• 

mode=name

  

either text, binary, or auto. Should the reply data be treated as a string (text) or an Array with data type integer[1] (binary). auto determines the data type by relying on the data type provided by the server. The default is auto.

• 

output=list

  

a list of one or more of content, headers, and code. This determines what will be returned by Delete. The output will be an expression sequence with the corresponding values. The default is [content].

• 

password=string

  

the password for authentication. This supersedes any password included in url directly.

• 

proxy=string

  

a URL for a proxy server. This should include the protocol, host, and port number (if not default), For example, to connect to an HTTP proxy myproxy on port 3421, use proxy=http://myproxy:3421.

• 

proxyuser=string

  

username to use for authentication against the proxy specified by the proxy option.

• 

proxypassword=string

  

password to use for authentication against the proxy specified by the proxy option.

• 

requestheaders=list(string) or table

  

a list of strings and equations of strings that will be added to the http header that is sent as part of the request.

• 

responseheaders=list(string)

  

a list of strings specifying header fields to be returned. This only has an effect if headers is specified in the output option. If this option is not given, all received headers will be returned.

• 

timeout=posint

  

the number of seconds to wait before aborting the transfer. The default is infinity (in other words, no timeout).

• 

user=string

  

the user name for authentication. This supersedes any user name included in url directly.

• 

verify=truefalse

  

should Maple authenticate the identity of the server by verifying its SSL certificate against a list of verified Certificate Authorities. The default is true. This option is only valid when using https.

Description

• 

The Delete method issues a request to the remote server to delete the resource specified by url, and returns the server response. The response will be returned as a string or Array with data type integer[1] (this can be controlled by the mode option).

• 

Delete supports two URL schemes: http and https. It issues a request to the specified server using the HTTP DELETE method.

• 

A Content-Type (as specified in the http header) of text will be returned as a string. All other content types are returned as an Array of integer[1]. This can be overridden using the mode option.

• 

The output option is a list of one or more of content, headers, and code.

  

content is the content returned by the URL. You can also specify content=string where the string is a filename to which the data will be written.

  

headers refers to the http (and https) header received from the server. It is not supported for URLs with the ftp scheme. It is returned as a table of strings.

  

code refers to the http (and https) status code returned by the server. It is not supported for URLs with the ftp scheme. It is returned as an integer.

Examples

URL:-Deletehttp://www.maplesoft.com:

Connect to maplesoft.com using proxy server http://myproxy on port 3421 with specified proxy user credentials.

URL:-Deletehttp://www.maplesoft.com,proxy=http://myproxy:3421,proxyuser=graymond,proxypassword=apple

References

  

RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, W3C.

Compatibility

• 

The URL[Delete] command was introduced in Maple 2017.

• 

For more information on Maple 2017 changes, see Updates in Maple 2017.

See Also

URL

URL,Get

URL,Head