getCurlInfo              package:RCurl              R Documentation

_A_c_c_e_s_s _i_n_f_o_r_m_a_t_i_o_n _a_b_o_u_t _a _C_U_R_L _r_e_q_u_e_s_t

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

     This function provides access to data about a previously executed
     CURL request that is accessible via a 'CURLHandle' object. This
     means, of course, that one must have access to the 'CURLHandle'
     object. The information one can get includes items such as the
     name of the file (potentially containing redirects), download
     time,

     See 'getCurlInfoConstants' for the names of the possible fields.

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

     getCurlInfo(curl, which = getCurlInfoConstants())
     getCurlInfoConstants()

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

    curl: the 'CURLHandle' object used to perform the request. This is
          a reference to an opaque internal C-level data structure that
          is provided and used by libcurl to make a request.

   which: identifiers for the elements of interest. These can be
          specified by integer value or by name. The names are matched
          against those in the 'getCurlInfoConstants'

     .

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

     This is an interface to the 'get_curl_info' routine in the libcurl
     package.

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

     A named list whose elements correspond to the requested fields.
     The names are expanded to match the names of these fields and the
     values are either strings or integer values.

_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:

     'curlPerform' 'getURL'   'getCurlHandle'

_E_x_a_m_p_l_e_s:

       curl = getCurlHandle()
       getURL("http://www.omegahat.org/RCurl/index.html", curl = curl)
       getCurlInfo(curl)
       rm(curl)  # release the curl!

