33
30
<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gstrtspurl.top_of_page"></a>gstrtspurl</span></h2>
34
31
<p>gstrtspurl — handling RTSP urls</p>
36
<td valign="top" align="right"></td>
33
<td class="gallery_image" valign="top" align="right"></td>
37
34
</tr></table></div>
38
<div class="refsynopsisdiv">
39
<a name="gst-plugins-base-libs-gstrtspurl.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
41
#include <gst/rtsp/gstrtspurl.h>
43
#define <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GST-RTSP-DEFAULT-PORT:CAPS" title="GST_RTSP_DEFAULT_PORT">GST_RTSP_DEFAULT_PORT</a>
44
struct <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl">GstRTSPUrl</a>;
45
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-parse" title="gst_rtsp_url_parse ()">gst_rtsp_url_parse</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *urlstr</code></em>,
46
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> **url</code></em>);
47
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-copy" title="gst_rtsp_url_copy ()">gst_rtsp_url_copy</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);
48
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()">gst_rtsp_url_free</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-get-request-uri" title="gst_rtsp_url_get_request_uri ()">gst_rtsp_url_get_request_uri</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);
50
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-set-port" title="gst_rtsp_url_set_port ()">gst_rtsp_url_set_port</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
51
<em class="parameter"><code><span class="type">guint16</span> port</code></em>);
52
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-get-port" title="gst_rtsp_url_get_port ()">gst_rtsp_url_get_port</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
53
<em class="parameter"><code><span class="type">guint16</span> *port</code></em>);
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-decode-path-components" title="gst_rtsp_url_decode_path_components ()">gst_rtsp_url_decode_path_components</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);
35
<div class="refsect1">
36
<a name="gst-plugins-base-libs-gstrtspurl.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
44
<td class="function_type">
45
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
47
<td class="function_name">
48
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-parse" title="gst_rtsp_url_parse ()">gst_rtsp_url_parse</a> <span class="c_punctuation">()</span>
52
<td class="function_type">
53
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> *
55
<td class="function_name">
56
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-copy" title="gst_rtsp_url_copy ()">gst_rtsp_url_copy</a> <span class="c_punctuation">()</span>
60
<td class="function_type">
61
<span class="returnvalue">void</span>
63
<td class="function_name">
64
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()">gst_rtsp_url_free</a> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
71
<td class="function_name">
72
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-get-request-uri" title="gst_rtsp_url_get_request_uri ()">gst_rtsp_url_get_request_uri</a> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
79
<td class="function_name">
80
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-set-port" title="gst_rtsp_url_set_port ()">gst_rtsp_url_set_port</a> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
87
<td class="function_name">
88
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-get-port" title="gst_rtsp_url_get_port ()">gst_rtsp_url_get_port</a> <span class="c_punctuation">()</span>
92
<td class="function_type">
93
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
95
<td class="function_name">
96
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-decode-path-components" title="gst_rtsp_url_decode_path_components ()">gst_rtsp_url_decode_path_components</a> <span class="c_punctuation">()</span>
102
<div class="refsect1">
103
<a name="gst-plugins-base-libs-gstrtspurl.other"></a><h2>Types and Values</h2>
104
<div class="informaltable"><table width="100%" border="0">
106
<col width="150px" class="name">
107
<col class="description">
111
<td class="define_keyword">#define</td>
112
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GST-RTSP-DEFAULT-PORT:CAPS" title="GST_RTSP_DEFAULT_PORT">GST_RTSP_DEFAULT_PORT</a></td>
115
<td class="datatype_keyword">struct</td>
116
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl">GstRTSPUrl</a></td>
121
<div class="refsect1">
122
<a name="gst-plugins-base-libs-gstrtspurl.object-hierarchy"></a><h2>Object Hierarchy</h2>
126
<div class="refsect1">
127
<a name="gst-plugins-base-libs-gstrtspurl.includes"></a><h2>Includes</h2>
128
<pre class="synopsis">#include <gst/rtsp/gstrtspurl.h>
57
131
<div class="refsect1">
58
132
<a name="gst-plugins-base-libs-gstrtspurl.description"></a><h2>Description</h2>
60
Provides helper functions to handle RTSP urls.
62
Last reviewed on 2007-07-25 (0.10.14)
65
<div class="refsect1">
66
<a name="gst-plugins-base-libs-gstrtspurl.details"></a><h2>Details</h2>
133
<p>Provides helper functions to handle RTSP urls.</p>
134
<p>Last reviewed on 2007-07-25 (0.10.14)</p>
136
<div class="refsect1">
137
<a name="gst-plugins-base-libs-gstrtspurl.functions_details"></a><h2>Functions</h2>
138
<div class="refsect2">
139
<a name="gst-rtsp-url-parse"></a><h3>gst_rtsp_url_parse ()</h3>
140
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
141
gst_rtsp_url_parse (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *urlstr</code></em>,
142
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> **url</code></em>);</pre>
143
<p>Parse the RTSP <em class="parameter"><code>urlstr</code></em>
144
into a newly allocated <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>. Free after usage
145
with <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()"><code class="function">gst_rtsp_url_free()</code></a>.</p>
146
<div class="refsect3">
147
<a name="id-1.2.10.9.8.2.5"></a><h4>Parameters</h4>
148
<div class="informaltable"><table width="100%" border="0">
150
<col width="150px" class="parameters_name">
151
<col class="parameters_description">
152
<col width="200px" class="parameters_annotations">
156
<td class="parameter_name"><p>urlstr</p></td>
157
<td class="parameter_description"><p>the url string to parse</p></td>
158
<td class="parameter_annotations"> </td>
161
<td class="parameter_name"><p>url</p></td>
162
<td class="parameter_description"><p> location to hold the result. </p></td>
163
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
168
<div class="refsect3">
169
<a name="id-1.2.10.9.8.2.6"></a><h4>Returns</h4>
170
<p> a <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p>
175
<div class="refsect2">
176
<a name="gst-rtsp-url-copy"></a><h3>gst_rtsp_url_copy ()</h3>
177
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> *
178
gst_rtsp_url_copy (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
179
<p>Make a copy of <em class="parameter"><code>url</code></em>
181
<div class="refsect3">
182
<a name="id-1.2.10.9.8.3.5"></a><h4>Parameters</h4>
183
<div class="informaltable"><table width="100%" border="0">
185
<col width="150px" class="parameters_name">
186
<col class="parameters_description">
187
<col width="200px" class="parameters_annotations">
190
<td class="parameter_name"><p>url</p></td>
191
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
192
<td class="parameter_annotations"> </td>
196
<div class="refsect3">
197
<a name="id-1.2.10.9.8.3.6"></a><h4>Returns</h4>
198
<p> a copy of <em class="parameter"><code>url</code></em>
199
. Free with <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()"><code class="function">gst_rtsp_url_free()</code></a> after usage.</p>
204
<div class="refsect2">
205
<a name="gst-rtsp-url-free"></a><h3>gst_rtsp_url_free ()</h3>
206
<pre class="programlisting"><span class="returnvalue">void</span>
207
gst_rtsp_url_free (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
208
<p>Free the memory used by <em class="parameter"><code>url</code></em>
210
<div class="refsect3">
211
<a name="id-1.2.10.9.8.4.5"></a><h4>Parameters</h4>
212
<div class="informaltable"><table width="100%" border="0">
214
<col width="150px" class="parameters_name">
215
<col class="parameters_description">
216
<col width="200px" class="parameters_annotations">
219
<td class="parameter_name"><p>url</p></td>
220
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
221
<td class="parameter_annotations"> </td>
227
<div class="refsect2">
228
<a name="gst-rtsp-url-get-request-uri"></a><h3>gst_rtsp_url_get_request_uri ()</h3>
229
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
230
gst_rtsp_url_get_request_uri (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
231
<p>Get a newly allocated string describing the request URI for <em class="parameter"><code>url</code></em>
233
<div class="refsect3">
234
<a name="id-1.2.10.9.8.5.5"></a><h4>Parameters</h4>
235
<div class="informaltable"><table width="100%" border="0">
237
<col width="150px" class="parameters_name">
238
<col class="parameters_description">
239
<col width="200px" class="parameters_annotations">
242
<td class="parameter_name"><p>url</p></td>
243
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
244
<td class="parameter_annotations"> </td>
248
<div class="refsect3">
249
<a name="id-1.2.10.9.8.5.6"></a><h4>Returns</h4>
250
<p> a string with the request URI. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after usage.</p>
255
<div class="refsect2">
256
<a name="gst-rtsp-url-set-port"></a><h3>gst_rtsp_url_set_port ()</h3>
257
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
258
gst_rtsp_url_set_port (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
259
<em class="parameter"><code><span class="type">guint16</span> port</code></em>);</pre>
260
<p>Set the port number in <em class="parameter"><code>url</code></em>
261
to <em class="parameter"><code>port</code></em>
263
<div class="refsect3">
264
<a name="id-1.2.10.9.8.6.5"></a><h4>Parameters</h4>
265
<div class="informaltable"><table width="100%" border="0">
267
<col width="150px" class="parameters_name">
268
<col class="parameters_description">
269
<col width="200px" class="parameters_annotations">
273
<td class="parameter_name"><p>url</p></td>
274
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
275
<td class="parameter_annotations"> </td>
278
<td class="parameter_name"><p>port</p></td>
279
<td class="parameter_description"><p>the port</p></td>
280
<td class="parameter_annotations"> </td>
285
<div class="refsect3">
286
<a name="id-1.2.10.9.8.6.6"></a><h4>Returns</h4>
287
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
292
<div class="refsect2">
293
<a name="gst-rtsp-url-get-port"></a><h3>gst_rtsp_url_get_port ()</h3>
294
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
295
gst_rtsp_url_get_port (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
296
<em class="parameter"><code><span class="type">guint16</span> *port</code></em>);</pre>
297
<p>Get the port number of <em class="parameter"><code>url</code></em>
299
<div class="refsect3">
300
<a name="id-1.2.10.9.8.7.5"></a><h4>Parameters</h4>
301
<div class="informaltable"><table width="100%" border="0">
303
<col width="150px" class="parameters_name">
304
<col class="parameters_description">
305
<col width="200px" class="parameters_annotations">
309
<td class="parameter_name"><p>url</p></td>
310
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
311
<td class="parameter_annotations"> </td>
314
<td class="parameter_name"><p>port</p></td>
315
<td class="parameter_description"><p>location to hold the port</p></td>
316
<td class="parameter_annotations"> </td>
321
<div class="refsect3">
322
<a name="id-1.2.10.9.8.7.6"></a><h4>Returns</h4>
323
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
328
<div class="refsect2">
329
<a name="gst-rtsp-url-decode-path-components"></a><h3>gst_rtsp_url_decode_path_components ()</h3>
330
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
331
gst_rtsp_url_decode_path_components (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
332
<p>Splits the path of <em class="parameter"><code>url</code></em>
333
on '/' boundaries, decoding the resulting components,</p>
334
<p>The decoding performed by this routine is "URI decoding", as defined in RFC
335
3986, commonly known as percent-decoding. For example, a string "foo%2fbar"
336
will decode to "foo/bar" -- the %2f being replaced by the corresponding byte
337
with hex value 0x2f. Note that there is no guarantee that the resulting byte
338
sequence is valid in any given encoding. As a special case, %00 is not
339
unescaped to NUL, as that would prematurely terminate the string.</p>
340
<p>Also note that since paths usually start with a slash, the first component
341
will usually be the empty string.</p>
342
<div class="refsect3">
343
<a name="id-1.2.10.9.8.8.7"></a><h4>Parameters</h4>
344
<div class="informaltable"><table width="100%" border="0">
346
<col width="150px" class="parameters_name">
347
<col class="parameters_description">
348
<col width="200px" class="parameters_annotations">
351
<td class="parameter_name"><p>url</p></td>
352
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td>
353
<td class="parameter_annotations"> </td>
357
<div class="refsect3">
358
<a name="id-1.2.10.9.8.8.8"></a><h4>Returns</h4>
359
<p> a string vector. <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> after usage.</p>
364
<div class="refsect1">
365
<a name="gst-plugins-base-libs-gstrtspurl.other_details"></a><h2>Types and Values</h2>
67
366
<div class="refsect2">
68
367
<a name="GST-RTSP-DEFAULT-PORT:CAPS"></a><h3>GST_RTSP_DEFAULT_PORT</h3>
69
368
<pre class="programlisting">#define GST_RTSP_DEFAULT_PORT 554
72
The default RTSP port to connect to.
370
<p>The default RTSP port to connect to.</p>
76
373
<div class="refsect2">
90
This structure contains the result of a parsed RTSP URL
92
<div class="variablelist"><table border="0" class="variablelist">
94
<col align="left" valign="top">
99
<td><p><span class="term"><a class="link" href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPLowerTrans" title="enum GstRTSPLowerTrans"><span class="type">GstRTSPLowerTrans</span></a> <em class="structfield"><code><a name="GstRTSPUrl.transports"></a>transports</code></em>;</span></p></td>
100
<td>the transports allowed</td>
103
<td><p><span class="term"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPFamily" title="enum GstRTSPFamily"><span class="type">GstRTSPFamily</span></a> <em class="structfield"><code><a name="GstRTSPUrl.family"></a>family</code></em>;</span></p></td>
107
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.user"></a>user</code></em>;</span></p></td>
111
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.passwd"></a>passwd</code></em>;</span></p></td>
112
<td>the password</td>
115
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.host"></a>host</code></em>;</span></p></td>
119
<td><p><span class="term"><span class="type">guint16</span> <em class="structfield"><code><a name="GstRTSPUrl.port"></a>port</code></em>;</span></p></td>
123
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.abspath"></a>abspath</code></em>;</span></p></td>
124
<td>the absolute path</td>
127
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.query"></a>query</code></em>;</span></p></td>
128
<td>additional query parameters</td>
134
<div class="refsect2">
135
<a name="gst-rtsp-url-parse"></a><h3>gst_rtsp_url_parse ()</h3>
136
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_url_parse (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *urlstr</code></em>,
137
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> **url</code></em>);</pre>
139
Parse the RTSP <em class="parameter"><code>urlstr</code></em> into a newly allocated <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>. Free after usage
140
with <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()"><code class="function">gst_rtsp_url_free()</code></a>.
142
<div class="variablelist"><table border="0" class="variablelist">
144
<col align="left" valign="top">
149
<td><p><span class="term"><em class="parameter"><code>urlstr</code></em> :</span></p></td>
150
<td>the url string to parse</td>
153
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
154
<td>location to hold the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
158
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</td>
165
<div class="refsect2">
166
<a name="gst-rtsp-url-copy"></a><h3>gst_rtsp_url_copy ()</h3>
167
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * gst_rtsp_url_copy (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
169
Make a copy of <em class="parameter"><code>url</code></em>.
171
<div class="variablelist"><table border="0" class="variablelist">
173
<col align="left" valign="top">
178
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
179
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
183
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
184
<td>a copy of <em class="parameter"><code>url</code></em>. Free with <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#gst-rtsp-url-free" title="gst_rtsp_url_free ()"><code class="function">gst_rtsp_url_free()</code></a> after usage.</td>
190
<div class="refsect2">
191
<a name="gst-rtsp-url-free"></a><h3>gst_rtsp_url_free ()</h3>
192
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_url_free (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
194
Free the memory used by <em class="parameter"><code>url</code></em>.
196
<div class="variablelist"><table border="0" class="variablelist">
198
<col align="left" valign="top">
202
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
203
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
209
<div class="refsect2">
210
<a name="gst-rtsp-url-get-request-uri"></a><h3>gst_rtsp_url_get_request_uri ()</h3>
211
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gst_rtsp_url_get_request_uri (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
213
Get a newly allocated string describing the request URI for <em class="parameter"><code>url</code></em>.
215
<div class="variablelist"><table border="0" class="variablelist">
217
<col align="left" valign="top">
222
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
223
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
227
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
228
<td>a string with the request URI. <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after usage.</td>
234
<div class="refsect2">
235
<a name="gst-rtsp-url-set-port"></a><h3>gst_rtsp_url_set_port ()</h3>
236
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_url_set_port (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
237
<em class="parameter"><code><span class="type">guint16</span> port</code></em>);</pre>
239
Set the port number in <em class="parameter"><code>url</code></em> to <em class="parameter"><code>port</code></em>.
241
<div class="variablelist"><table border="0" class="variablelist">
243
<col align="left" valign="top">
248
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
249
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
253
<td><p><span class="term"><em class="parameter"><code>port</code></em> :</span></p></td>
257
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
259
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
265
<div class="refsect2">
266
<a name="gst-rtsp-url-get-port"></a><h3>gst_rtsp_url_get_port ()</h3>
267
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_url_get_port (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
268
<em class="parameter"><code><span class="type">guint16</span> *port</code></em>);</pre>
270
Get the port number of <em class="parameter"><code>url</code></em>.
272
<div class="variablelist"><table border="0" class="variablelist">
274
<col align="left" valign="top">
279
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
280
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
284
<td><p><span class="term"><em class="parameter"><code>port</code></em> :</span></p></td>
285
<td>location to hold the port</td>
288
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
290
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
296
<div class="refsect2">
297
<a name="gst-rtsp-url-decode-path-components"></a><h3>gst_rtsp_url_decode_path_components ()</h3>
298
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gst_rtsp_url_decode_path_components (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>);</pre>
300
Splits the path of <em class="parameter"><code>url</code></em> on '/' boundaries, decoding the resulting components,
303
The decoding performed by this routine is "URI decoding", as defined in RFC
304
3986, commonly known as percent-decoding. For example, a string "foo%2fbar"
305
will decode to "foo/bar" -- the %2f being replaced by the corresponding byte
306
with hex value 0x2f. Note that there is no guarantee that the resulting byte
307
sequence is valid in any given encoding. As a special case, %00 is not
308
unescaped to NUL, as that would prematurely terminate the string.
311
Also note that since paths usually start with a slash, the first component
312
will usually be the empty string.
314
<div class="variablelist"><table border="0" class="variablelist">
316
<col align="left" valign="top">
321
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
322
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
326
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
327
<td>a string vector. <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> after usage.</td>
386
<p>This structure contains the result of a parsed RTSP URL</p>
387
<div class="refsect3">
388
<a name="id-1.2.10.9.9.3.5"></a><h4>Members</h4>
389
<div class="informaltable"><table width="100%" border="0">
391
<col width="300px" class="struct_members_name">
392
<col class="struct_members_description">
393
<col width="200px" class="struct_members_annotations">
397
<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPLowerTrans" title="enum GstRTSPLowerTrans"><span class="type">GstRTSPLowerTrans</span></a> <em class="structfield"><code><a name="GstRTSPUrl.transports"></a>transports</code></em>;</p></td>
398
<td class="struct_member_description"><p>the transports allowed</p></td>
399
<td class="struct_member_annotations"> </td>
402
<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPFamily" title="enum GstRTSPFamily"><span class="type">GstRTSPFamily</span></a> <em class="structfield"><code><a name="GstRTSPUrl.family"></a>family</code></em>;</p></td>
403
<td class="struct_member_description"><p>the family</p></td>
404
<td class="struct_member_annotations"> </td>
407
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.user"></a>user</code></em>;</p></td>
408
<td class="struct_member_description"><p>the user</p></td>
409
<td class="struct_member_annotations"> </td>
412
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.passwd"></a>passwd</code></em>;</p></td>
413
<td class="struct_member_description"><p>the password</p></td>
414
<td class="struct_member_annotations"> </td>
417
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.host"></a>host</code></em>;</p></td>
418
<td class="struct_member_description"><p>the host</p></td>
419
<td class="struct_member_annotations"> </td>
422
<td class="struct_member_name"><p><span class="type">guint16</span> <em class="structfield"><code><a name="GstRTSPUrl.port"></a>port</code></em>;</p></td>
423
<td class="struct_member_description"><p>the port</p></td>
424
<td class="struct_member_annotations"> </td>
427
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.abspath"></a>abspath</code></em>;</p></td>
428
<td class="struct_member_description"><p>the absolute path</p></td>
429
<td class="struct_member_annotations"> </td>
432
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPUrl.query"></a>query</code></em>;</p></td>
433
<td class="struct_member_description"><p>additional query parameters</p></td>
434
<td class="struct_member_annotations"> </td>
334
442
<div class="footer">
336
Generated by GTK-Doc V1.19</div>
444
Generated by GTK-Doc V1.20</div>
b'\\ No newline at end of file'