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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Octave: URL Manipulation</title>
<meta name="description" content="GNU Octave: URL Manipulation">
<meta name="keywords" content="GNU Octave: URL Manipulation">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<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>
</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>Loadable Function: <em><var>s</var> =</em> <strong>urlread</strong> <em>(<var>url</var>)</em></dt>
<dt><a name="index-urlread-1"></a>Loadable Function: <em>[<var>s</var>, <var>success</var>] =</em> <strong>urlread</strong> <em>(<var>url</var>)</em></dt>
<dt><a name="index-urlread-2"></a>Loadable Function: <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>Loadable Function: <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>Loadable Function: <em></em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dt><a name="index-urlwrite-1"></a>Loadable Function: <em><var>f</var> =</em> <strong>urlwrite</strong> <em>(<var>url</var>, <var>localfile</var>)</em></dt>
<dt><a name="index-urlwrite-2"></a>Loadable Function: <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>Loadable Function: <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>
|
