Equal to etc.c.curl.CURLcode
Flag to specify whether or not an exception is thrown on error.
Exception thrown on errors in std.net.curl functions.
Exception thrown on timeout errors in std.net.curl functions.
Exception thrown on HTTP request failures, e.g. 404 Not Found.
HTTP/FTP fetch content as a range of chunks.
HTTP/FTP fetch content as a range of chunks asynchronously.
HTTP/FTP fetch content as a range of lines.
HTTP/FTP fetch content as a range of lines asynchronously.
HTTP connect request.
HTTP/FTP delete content.
HTTP/FTP download to local file system.
HTTP/FTP get content.
HTTP options request.
HTTP patch content.
HTTP post content.
HTTP/FTP put content.
HTTP trace request.
Upload file from local files system using the HTTP or FTP protocol.
Test server
Connection type used when the URL should be used to auto detect the protocol.
Wrapper to provide a better interface to libcurl than using the plain C API. It is recommended to use the HTTP/FTP etc. structs instead unless raw access to libcurl is needed.
FTP client functionality.
Tracking progress:
Basic SMTP protocol support.
Thread-local storage init
1 import std.net.curl, std.stdio; 2 3 // Return a char[] containing the content specified by a URL 4 auto content = get("dlang.org"); 5 6 // Post data and return a char[] containing the content specified by a URL 7 auto content = post("mydomain.com/here.cgi", ["name1" : "value1", "name2" : "value2"]); 8 9 // Get content of file from ftp server 10 auto content = get("ftp.digitalmars.com/sieve.ds"); 11 12 // Post and print out content line by line. The request is done in another thread. 13 foreach (line; byLineAsync("dlang.org", "Post data")) 14 writeln(line); 15 16 // Get using a line range and proxy settings 17 auto client = HTTP(); 18 client.proxy = "1.2.3.4"; 19 foreach (line; byLine("dlang.org", client)) 20 writeln(line);
For more control than the high level functions provide, use the low level API:
import std.net.curl, std.stdio; // GET with custom data receivers auto http = HTTP("dlang.org"); http.onReceiveHeader = (in char[] key, in char[] value) { writeln(key, ": ", value); }; http.onReceive = (ubyte[] data) { /+ drop +/ return data.length; }; http.perform();
First, an instance of the reference-counted HTTP struct is created. Then the custom delegates are set. These will be called whenever the HTTP instance receives a header and a data buffer, respectively. In this simple example, the headers are written to stdout and the data is ignored. If the request should be stopped before it has finished then return something less than data.length from the onReceive callback. See onReceiveHeader/onReceive for more information. Finally the HTTP request is effected by calling perform(), which is synchronous.
Copyright Jonas Drewsen 2011-2012
Networking client functionality as provided by libcurl. The libcurl library must be installed on the system in order to use this module.
Note: You may need to link to the curl library, e.g. by adding "libs": ["curl"] to your dub.json file if you are using DUB.
Windows x86 note: A DMD compatible libcurl static library can be downloaded from the dlang.org download archive page.
This module is not available for iOS, tvOS or watchOS.
Compared to using libcurl directly this module allows simpler client code for common uses, requires no unsafe operations, and integrates better with the rest of the language. Futhermore it provides range access to protocols supported by libcurl both synchronously and asynchronously.
A high level and a low level API are available. The high level API is built entirely on top of the low level one.
The high level API is for commonly used functionality such as HTTP/FTP get. The byLineAsync and byChunkAsync provides asynchronous range that performs the request in another thread while handling a line/chunk in the current thread.
The low level API allows for streaming and other advanced features.