Complete an asynchronous HTTP request

Description

This is a generic function that is used within the RCurl package to force the completion of an HTTP request. If the request is asynchronous, this essentially blocks until the request is completed by repeatedly asking for more information to be retrieved from the HTTP connection.

Usage

complete(obj, ...)

Arguments

Value

The value is typically not of interest, but rather the side effect of processing the pending requests.

Author(s)

Duncan Temple Lang

References

http://curl.haxx.se, specifically the multi interface of libcurl.

See Also

MultiCURLHandle-class push, pop

Examples

if(url.exists("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl")) {

  f = system.file("NAMESPACE", package = "RCurl")
   postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
            "fileData" = fileUpload(f))


   postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
            "fileData" = fileUpload("",
                                    paste(readLines(f), collapse = "\n"),
                                    "text/plain"))

   postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
            "fileData" = fileUpload(f,
                                    paste(readLines(f), collapse = "\n")
                                    ),
            .opts = list(verbose = TRUE, header = TRUE))
}

Results

R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(RCurl)
Loading required package: bitops
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/RCurl/complete.Rd_%03d_medium.png", width=480, height=480)
> ### Name: complete
> ### Title: Complete an asynchronous HTTP request
> ### Aliases: complete complete,MultiCURLHandle-method
> ### Keywords: IO
> 
> ### ** Examples
> 
> if(url.exists("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl")) {
+ 
+   f = system.file("NAMESPACE", package = "RCurl")
+    postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
+             "fileData" = fileUpload(f))
+ 
+ 
+    postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
+             "fileData" = fileUpload("",
+                                     paste(readLines(f), collapse = "\n"),
+                                     "text/plain"))
+ 
+    postForm("http://eeyore.ucdavis.edu/cgi-bin/testForm1.pl",
+             "fileData" = fileUpload(f,
+                                     paste(readLines(f), collapse = "\n")
+                                     ),
+             .opts = list(verbose = TRUE, header = TRUE))
+ }
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>