| 1 |
\name{CURLHandle-class} |
| 2 |
\docType{class} |
| 3 |
\alias{CURLHandle-class} |
| 4 |
|
| 5 |
\title{Class "CURLHandle" for synchronous HTTP requests} |
| 6 |
\description{ |
| 7 |
This is the basic class used for performing HTTP requests |
| 8 |
in the RCurl package. |
| 9 |
In R, this is a reference to a C-level data structure |
| 10 |
so we treat it as an opaque data type. However, |
| 11 |
essentially we can think of this as an with |
| 12 |
a set of options that persists across calls, i.e. HTTP requests. |
| 13 |
The numerous options that one can set can be see via |
| 14 |
\code{\link{getCurlOptionsConstants}}. |
| 15 |
The object can keep a connection to a Web server open for a period of time |
| 16 |
across calls. |
| 17 |
|
| 18 |
This class differs from \code{\link{MultiCURLHandle-class}} as it |
| 19 |
can handle only one request at a time and blocks until the request |
| 20 |
is completed (normally or abnormally). |
| 21 |
The other class can handle asynchronous, multiple connections. |
| 22 |
} |
| 23 |
\section{Objects from the Class}{A virtual Class: No objects may be created from it.} |
| 24 |
\section{Extends}{ |
| 25 |
Class \code{"oldClass"}, directly. |
| 26 |
} |
| 27 |
%\section{Methods}{ \describe{}} |
| 28 |
\references{ |
| 29 |
\url{https://curl.se/}, the libcurl web site. |
| 30 |
} |
| 31 |
\author{Duncan Temple Lang} |
| 32 |
|
| 33 |
\seealso{ |
| 34 |
\code{\link{getURL}}, \code{\link{getForm}}, \code{\link{postForm}} |
| 35 |
\code{\link{dupCurlHandle}}, |
| 36 |
\code{\link{getCurlHandle}}, |
| 37 |
\code{\link{MultiCURLHandle-class}} |
| 38 |
} |
| 39 |
%\examples{} |
| 40 |
\keyword{classes} |