octave: URL Manipulation

 
 36.4.2 URL Manipulation
 -----------------------
 
  -- : S = urlread (URL)
  -- : [S, SUCCESS] = urlread (URL)
  -- : [S, SUCCESS, MESSAGE] = urlread (URL)
  -- : [...] = urlread (URL, METHOD, PARAM)
      Download a remote file specified by its URL and return its content
      in string S.
 
      For example:
 
           s = urlread ("ftp://ftp.octave.org/pub/README");
 
      The variable SUCCESS is 1 if the download was successful, otherwise
      it is 0 in which case MESSAGE contains an error message.
 
      If no output argument is specified and an error occurs, then the
      error is signaled through Octave’s error handling mechanism.
 
      This function uses libcurl.  Curl supports, among others, the HTTP,
      FTP, and FILE protocols.  Username and password may be specified in
      the URL.  For example:
 
           s = urlread ("http://user:password@example.com/file.txt");
 
      GET and POST requests can be specified by METHOD and PARAM.  The
      parameter METHOD is either ‘get’ or ‘post’ and PARAM is a cell
      array of parameter and value pairs.  For example:
 
           s = urlread ("http://www.google.com/search", "get",
                       {"query", "octave"});
 
      See also: Seeurlwrite XREFurlwrite.
 
  -- : urlwrite (URL, LOCALFILE)
  -- : F = urlwrite (URL, LOCALFILE)
  -- : [F, SUCCESS] = urlwrite (URL, LOCALFILE)
  -- : [F, SUCCESS, MESSAGE] = urlwrite (URL, LOCALFILE)
      Download a remote file specified by its URL and save it as
      LOCALFILE.
 
      For example:
 
           urlwrite ("ftp://ftp.octave.org/pub/README",
                     "README.txt");
 
      The full path of the downloaded file is returned in F.
 
      The variable SUCCESS is 1 if the download was successful, otherwise
      it is 0 in which case MESSAGE contains an error message.
 
      If no output argument is specified and an error occurs, then the
      error is signaled through Octave’s error handling mechanism.
 
      This function uses libcurl.  Curl supports, among others, the HTTP,
      FTP, and FILE protocols.  Username and password may be specified in
      the URL, for example:
 
           urlwrite ("http://username:password@example.com/file.txt",
                     "file.txt");
 
      GET and POST requests can be specified by METHOD and PARAM.  The
      parameter METHOD is either ‘get’ or ‘post’ and PARAM is a cell
      array of parameter and value pairs.  For example:
 
           urlwrite ("http://www.google.com/search", "search.html",
                     "get", {"query", "octave"});
 
      See also: Seeurlread XREFurlread.