View source code
Display the source code in std/net/curl.d from which this page was generated on
github.
Improve this page
Quickly fork, edit online, and submit a pull request for this page.
Requires a signed-in GitHub account. This works well for small changes.
If you'd like to make larger changes you may want to consider using
local clone.
Page wiki
View or edit the community-maintained wiki page associated with this page.
Struct std.net.curl.Curl
Wrapper to provide a better interface to libcurl than using the plain C API.
It is recommended to use the HTTPFTP
Properties
| Name | Type | Description |
|---|---|---|
onProgress
[set]
|
int delegate(ulong, ulong, ulong, ulong) |
The event handler that gets called to inform of upload/download progress.
|
onReceive
[set]
|
ulong delegate(ubyte[]) |
The event handler that receives incoming data. |
onReceiveHeader
[set]
|
void delegate(const(char[])) |
The event handler that receives incoming headers for protocols that uses headers. |
onSeek
[set]
|
CurlSeek delegate(long, CurlSeekPos) |
The event handler that gets called when the curl backend needs to seek the data to be sent. |
onSend
[set]
|
ulong delegate(void[]) |
The event handler that gets called when data is needed for sending. |
onSocketOption
[set]
|
int delegate(std. |
The event handler that gets called when the net socket has been created
but a set
misc. socket options.
|
Methods
| Name | Description |
|---|---|
clear
|
Clear a pointer option.
|
clearIfSupported
|
Clear a pointer option. Does not raise an exception if the underlying
libcurl does not support the option. Use sparingly.
|
dup
|
Duplicate this handle. |
initialize
|
Initialize the instance by creating a working curl handle. |
pause
|
Pausing and continuing transfers. |
perform
|
perform the curl request by doing the HTTP,FTP etc. as it has
been setup beforehand.
|
set
|
Set a string curl option.
|
set
|
Set a long curl option.
|
set
|
Set a void* curl option.
|
shutdown
|
Stop and invalidate this curl instance. |
Warning
This struct uses interior pointers for callbacks. Only allocate it
on the stack if you never move or copy it. This also means passing by reference
when passing Curl to other functions. Otherwise always allocate on
the heap.
Authors
Jonas Drewsen. Some of the SMTP code contributed by Jimmy Cao.