std.net.curl

Members

Aliases

CurlCode

alias CurlCode = CURLcode

Equal to etc.c.curl.CURLcode

ThrowOnError

alias ThrowOnError = Flag!"throwOnError"

Flag to specify whether or not an exception is thrown on error.

Classes

CurlException

class CurlException

Exception thrown on errors in std.net.curl functions.

CurlTimeoutException

class CurlTimeoutException

Exception thrown on timeout errors in std.net.curl functions.

HTTPStatusException

class HTTPStatusException

Exception thrown on HTTP request failures, e.g. 404 Not Found.

Enums

CurlOption (from etc.c.curl)

enum CurlOption via public import etc.c.curl : CurlOption;

Functions

byChunk

auto byChunk(const(char)[] url, size_t chunkSize, Conn conn)

HTTP/FTP fetch content as a range of chunks.

byChunkAsync

auto byChunkAsync(const(char)[] url, const(PostUnit)[] postData, size_t chunkSize, size_t transmitBuffers, Conn conn)

auto byChunkAsync(const(char)[] url, size_t chunkSize, size_t transmitBuffers, Conn conn)

HTTP/FTP fetch content as a range of chunks asynchronously.

byLine

auto byLine(const(char)[] url, KeepTerminator keepTerminator, Terminator terminator, Conn conn)

HTTP/FTP fetch content as a range of lines.

byLineAsync

auto byLineAsync(const(char)[] url, const(PostUnit)[] postData, KeepTerminator keepTerminator, Terminator terminator, size_t transmitBuffers, Conn conn)

auto byLineAsync(const(char)[] url, KeepTerminator keepTerminator, Terminator terminator, size_t transmitBuffers, Conn conn)

HTTP/FTP fetch content as a range of lines asynchronously.

connect

T[] connect(const(char)[] url, HTTP conn)

HTTP connect request.

del

void del(const(char)[] url, Conn conn)

HTTP/FTP delete content.

download

void download(const(char)[] url, string saveToPath, Conn conn)

HTTP/FTP download to local file system.

get

T[] get(const(char)[] url, Conn conn)

HTTP/FTP get content.

options

T[] options(const(char)[] url, HTTP conn)

HTTP options request.

patch

T[] patch(const(char)[] url, const(PatchUnit)[] patchData, HTTP conn)

HTTP patch content.

post

T[] post(const(char)[] url, const(PostUnit)[] postData, HTTP conn)

T[] post(const(char)[] url, string[string] postDict, HTTP conn)

HTTP post content.

put

T[] put(const(char)[] url, const(PutUnit)[] putData, Conn conn)

HTTP/FTP put content.

trace

T[] trace(const(char)[] url, HTTP conn)

HTTP trace request.

upload

void upload(string loadFromPath, const(char)[] url, Conn conn)

Upload file from local files system using the HTTP or FTP protocol.

Static variables

server

TestServer server;

Test server

Structs

AutoProtocol

struct AutoProtocol

Connection type used when the URL should be used to auto detect the protocol.

Curl

struct Curl

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

struct FTP

FTP client functionality.

HTTP

struct HTTP

Tracking progress:

SMTP

struct SMTP

Basic SMTP protocol support.

Variables

tlsInit

bool tlsInit;

Thread-local storage init

import std.net.curl, std.stdio;

// Return a char[] containing the content specified by a URL
auto content = get("dlang.org");

// Post data and return a char[] containing the content specified by a URL
auto content = post("mydomain.com/here.cgi", ["name1" : "value1", "name2" : "value2"]);

// Get content of file from ftp server
auto content = get("ftp.digitalmars.com/sieve.ds");

// Post and print out content line by line. The request is done in another thread.
foreach (line; byLineAsync("dlang.org", "Post data"))
    writeln(line);

// Get using a line range and proxy settings
auto client = HTTP();
client.proxy = "1.2.3.4";
foreach (line; byLine("dlang.org", client))
    writeln(line);

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();

• curl
• isemail