getCurlHandle             package:RCurl             R Documentation

_C_r_e_a_t_e _l_i_b_c_u_r_l _h_a_n_d_l_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     These functions create and duplicate curl handles for use in calls
     to the HTTP facilities provided by that low-level language and
     this R-level interface. A curl handle is an opaque data type that
     contains a reference to the internal C-level data structure of
     libcurl for performing HTTP requests.

     The 'getCurlMutliHandle' returns an object that can be used for
     concurrent, multiple requests. It is quite different from the
     regular curl handle and again, should be treated as an opaque data
     type.

_U_s_a_g_e:

     getCurlHandle(..., .opts = NULL, .encoding = integer())
     dupCurlHandle(curl, ..., .opts = NULL, .encoding = integer())
     getCurlMultiHandle()

_A_r_g_u_m_e_n_t_s:

    curl: the existing curl handle that is to be duplicated

     ...: a named list of curl options to set after the handle has been
          created.

   .opts: a named list or 'CURLOptions' object identifying the curl
          options for the handle. These and the '...' arguments are
          used after the handle has been created.

.encoding: an integer or a string that explicitly identifies the
          encoding of the content that is returned by the HTTP server
          in its response to our query. The possible strings are
          UTF-8 or ISO-8859-1 and the integers should be specified
          symbolically as  'CE_UTF8' and 'CE_LATIN1'. Note that, by
          default, the package attempts to process the header of the
          HTTP response to determine the encoding. This argument is
          used when such information is erroneous and the caller knows
          the correct encoding. 

_D_e_t_a_i_l_s:

     These functions create C-level data structures.

_V_a_l_u_e:

     An object of class 'CURLHandle' which is simply a pointer to the
     memory for the C structure.

_A_u_t_h_o_r(_s):

     Duncan Temple Lang <duncan@wald.ucdavis.edu>

_R_e_f_e_r_e_n_c_e_s:

     Curl homepage <URL: http://curl.haxx.se>

_S_e_e _A_l_s_o:

     'getURL' 'curlPerform'

