/usr/share/doc/octave/octave.html/URL-Manipulation.html is in octave-doc 4.2.2-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>URL Manipulation (GNU Octave)</title>
<meta name="description" content="URL Manipulation (GNU Octave)">
<meta name="keywords" content="URL Manipulation (GNU Octave)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Networking-Utilities.html#Networking-Utilities" rel="up" title="Networking Utilities">
<link href="Base64-and-Binary-Data-Transmission.html#Base64-and-Binary-Data-Transmission" rel="next" title="Base64 and Binary Data Transmission">
<link href="FTP-Objects.html#FTP-Objects" rel="prev" title="FTP Objects">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="octave.css">
</head>
<body lang="en">
<a name="URL-Manipulation"></a>
<div class="header">
<p>
Next: <a href="Base64-and-Binary-Data-Transmission.html#Base64-and-Binary-Data-Transmission" accesskey="n" rel="next">Base64 and Binary Data Transmission</a>, Previous: <a href="FTP-Objects.html#FTP-Objects" accesskey="p" rel="prev">FTP Objects</a>, Up: <a href="Networking-Utilities.html#Networking-Utilities" accesskey="u" rel="up">Networking Utilities</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="URL-Manipulation-1"></a>
<h4 class="subsection">36.4.2 URL Manipulation</h4>
<a name="XREFurlread"></a><dl>
<dt><a name="index-urlread"></a>: <em><var>s</var> =</em> <strong>urlread</strong> <em>(<var>url</var>)</em></dt>
<dt><a name="index-urlread-1"></a>: <em>[<var>s</var>, <var>success</var>] =</em> <strong>urlread</strong> <em>(<var>url</var>)</em></dt>
<dt><a name="index-urlread-2"></a>: <em>[<var>s</var>, <var>success</var>, <var>message</var>] =</em> <strong>urlread</strong> <em>(<var>url</var>)</em></dt>
<dt><a name="index-urlread-3"></a>: <em>[…] =</em> <strong>urlread</strong> <em>(<var>url</var>, <var>method</var>, <var>param</var>)</em></dt>
<dd><p>Download a remote file specified by its <var>url</var> and return its content
in string <var>s</var>.
</p>
<p>For example:
</p>
<div class="example">
<pre class="example">s = urlread ("ftp://ftp.octave.org/pub/README");
</pre></div>
<p>The variable <var>success</var> is 1 if the download was successful,
otherwise it is 0 in which case <var>message</var> contains an error
message.
</p>
<p>If no output argument is specified and an error occurs, then the error is
signaled through Octave’s error handling mechanism.
</p>
<p>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:
</p>
<div class="example">
<pre class="example">s = urlread ("http://user:password@example.com/file.txt");
</pre></div>
<p>GET and POST requests can be specified by <var>method</var> and <var>param</var>.
The parameter <var>method</var> is either ‘<samp>get</samp>’ or ‘<samp>post</samp>’ and
<var>param</var> is a cell array of parameter and value pairs.
For example:
</p>
<div class="example">
<pre class="example">s = urlread ("http://www.google.com/search", "get",
{"query", "octave"});
</pre></div>
<p><strong>See also:</strong> <a href="#XREFurlwrite">urlwrite</a>.
</p></dd></dl>
<a name="XREFurlwrite"></a><dl>
<dt><a name="index-urlwrite"></a>: <em></em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dt><a name="index-urlwrite-1"></a>: <em><var>f</var> =</em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dt><a name="index-urlwrite-2"></a>: <em>[<var>f</var>, <var>success</var>] =</em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dt><a name="index-urlwrite-3"></a>: <em>[<var>f</var>, <var>success</var>, <var>message</var>] =</em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dd><p>Download a remote file specified by its <var>url</var> and save it as
<var>localfile</var>.
</p>
<p>For example:
</p>
<div class="example">
<pre class="example">urlwrite ("ftp://ftp.octave.org/pub/README",
"README.txt");
</pre></div>
<p>The full path of the downloaded file is returned in <var>f</var>.
</p>
<p>The variable <var>success</var> is 1 if the download was successful,
otherwise it is 0 in which case <var>message</var> contains an error message.
</p>
<p>If no output argument is specified and an error occurs, then the error is
signaled through Octave’s error handling mechanism.
</p>
<p>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:
</p>
<div class="example">
<pre class="example">urlwrite ("http://username:password@example.com/file.txt",
"file.txt");
</pre></div>
<p>GET and POST requests can be specified by <var>method</var> and <var>param</var>.
The parameter <var>method</var> is either ‘<samp>get</samp>’ or ‘<samp>post</samp>’ and
<var>param</var> is a cell array of parameter and value pairs.
For example:
</p>
<div class="example">
<pre class="example">urlwrite ("http://www.google.com/search", "search.html",
"get", {"query", "octave"});
</pre></div>
<p><strong>See also:</strong> <a href="#XREFurlread">urlread</a>.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Base64-and-Binary-Data-Transmission.html#Base64-and-Binary-Data-Transmission" accesskey="n" rel="next">Base64 and Binary Data Transmission</a>, Previous: <a href="FTP-Objects.html#FTP-Objects" accesskey="p" rel="prev">FTP Objects</a>, Up: <a href="Networking-Utilities.html#Networking-Utilities" accesskey="u" rel="up">Networking Utilities</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|