← Back to branch summary

~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GNetworkAddress.html

  • Committer: Package Import Robot
  • Author(s): Andreas Henriksson
  • Date: 2014-03-24 20:58:34 UTC
  • mfrom: (1.66.13)
  • Revision ID: package-import@ubuntu.com-20140324205834-8hsgok8k36ftocqa
Tags: 2.40.0-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/html/GNetworkAddress.html
51
51
</td>
52
52
</tr>
53
53
<tr>
54
 
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
54
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
55
55
</td>
56
56
<td class="function_name">
57
57
<a class="link" href="GNetworkAddress.html#g-network-address-get-hostname" title="g_network_address_get_hostname ()">g_network_address_get_hostname</a> <span class="c_punctuation">()</span>
59
59
</tr>
60
60
<tr>
61
61
<td class="function_type">
62
 
<a href="../glib/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a>
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a>
63
63
</td>
64
64
<td class="function_name">
65
65
<a class="link" href="GNetworkAddress.html#g-network-address-get-port" title="g_network_address_get_port ()">g_network_address_get_port</a> <span class="c_punctuation">()</span>
66
66
</td>
67
67
</tr>
68
68
<tr>
69
 
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
69
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
70
70
</td>
71
71
<td class="function_name">
72
72
<a class="link" href="GNetworkAddress.html#g-network-address-get-scheme" title="g_network_address_get_scheme ()">g_network_address_get_scheme</a> <span class="c_punctuation">()</span>
102
102
<tbody>
103
103
<tr>
104
104
<td class="property_type">
105
 
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
105
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
106
106
<td class="property_name"><a class="link" href="GNetworkAddress.html#GNetworkAddress--hostname" title="The “hostname” property">hostname</a></td>
107
107
<td class="property_flags">Read / Write / Construct Only</td>
108
108
</tr>
109
109
<tr>
110
 
<td class="property_type"><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
 
110
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
111
111
<td class="property_name"><a class="link" href="GNetworkAddress.html#GNetworkAddress--port" title="The “port” property">port</a></td>
112
112
<td class="property_flags">Read / Write / Construct Only</td>
113
113
</tr>
114
114
<tr>
115
115
<td class="property_type">
116
 
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
 
116
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
117
117
<td class="property_name"><a class="link" href="GNetworkAddress.html#GNetworkAddress--scheme" title="The “scheme” property">scheme</a></td>
118
118
<td class="property_flags">Read / Write / Construct Only</td>
119
119
</tr>
135
135
</div>
136
136
<div class="refsect1">
137
137
<a name="GNetworkAddress.object-hierarchy"></a><h2>Object Hierarchy</h2>
138
 
<pre class="screen">    <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
138
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
139
139
    <span class="lineart">╰──</span> GNetworkAddress
140
140
</pre>
141
141
</div>
163
163
<div class="refsect2">
164
164
<a name="g-network-address-new"></a><h3>g_network_address_new ()</h3>
165
165
<pre class="programlisting"><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="returnvalue">GSocketConnectable</span></a> *
166
 
g_network_address_new (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hostname</code></em>,
167
 
                       <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> port</code></em>);</pre>
 
166
g_network_address_new (<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> *hostname</code></em>,
 
167
                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> port</code></em>);</pre>
168
168
<p>Creates a new <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> for connecting to the given
169
169
<em class="parameter"><code>hostname</code></em>
170
170
 and <em class="parameter"><code>port</code></em>
201
201
<hr>
202
202
<div class="refsect2">
203
203
<a name="g-network-address-get-hostname"></a><h3>g_network_address_get_hostname ()</h3>
204
 
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
204
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
205
205
g_network_address_get_hostname (<em class="parameter"><code><a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a> *addr</code></em>);</pre>
206
206
<p>Gets <em class="parameter"><code>addr</code></em>
207
207
's hostname. This might be either UTF-8 or ASCII-encoded,
233
233
<hr>
234
234
<div class="refsect2">
235
235
<a name="g-network-address-get-port"></a><h3>g_network_address_get_port ()</h3>
236
 
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a>
 
236
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="returnvalue">guint16</span></a>
237
237
g_network_address_get_port (<em class="parameter"><code><a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a> *addr</code></em>);</pre>
238
238
<p>Gets <em class="parameter"><code>addr</code></em>
239
239
's port number</p>
263
263
<hr>
264
264
<div class="refsect2">
265
265
<a name="g-network-address-get-scheme"></a><h3>g_network_address_get_scheme ()</h3>
266
 
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
266
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
267
267
g_network_address_get_scheme (<em class="parameter"><code><a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a> *addr</code></em>);</pre>
268
268
<p>Gets <em class="parameter"><code>addr</code></em>
269
269
's scheme</p>
285
285
<div class="refsect3">
286
286
<a name="id-1.4.16.6.10.5.6"></a><h4>Returns</h4>
287
287
<p> <em class="parameter"><code>addr</code></em>
288
 
's scheme (<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not built from URI)</p>
 
288
's scheme (<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not built from URI)</p>
289
289
<p></p>
290
290
</div>
291
291
<p class="since">Since 2.26</p>
294
294
<div class="refsect2">
295
295
<a name="g-network-address-parse"></a><h3>g_network_address_parse ()</h3>
296
296
<pre class="programlisting"><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="returnvalue">GSocketConnectable</span></a> *
297
 
g_network_address_parse (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host_and_port</code></em>,
298
 
                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
299
 
                         <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
297
g_network_address_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> *host_and_port</code></em>,
 
298
                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
 
299
                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
300
300
<p>Creates a new <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> for connecting to the given
301
301
<em class="parameter"><code>hostname</code></em>
302
302
 and <em class="parameter"><code>port</code></em>
303
 
. May fail and return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case
 
303
. May fail and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case
304
304
parsing <em class="parameter"><code>host_and_port</code></em>
305
305
 fails.</p>
306
306
<p><em class="parameter"><code>host_and_port</code></em>
345
345
</tr>
346
346
<tr>
347
347
<td class="parameter_name"><p>error</p></td>
348
 
<td class="parameter_description"><p>a pointer to a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
348
<td class="parameter_description"><p>a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
349
349
<td class="parameter_annotations"> </td>
350
350
</tr>
351
351
</tbody>
353
353
</div>
354
354
<div class="refsect3">
355
355
<a name="id-1.4.16.6.10.6.10"></a><h4>Returns</h4>
356
 
<p> the new <a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
 
356
<p> the new <a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
357
357
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
358
358
</div>
359
359
<p class="since">Since 2.22</p>
362
362
<div class="refsect2">
363
363
<a name="g-network-address-parse-uri"></a><h3>g_network_address_parse_uri ()</h3>
364
364
<pre class="programlisting"><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="returnvalue">GSocketConnectable</span></a> *
365
 
g_network_address_parse_uri (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>,
366
 
                             <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
367
 
                             <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
365
g_network_address_parse_uri (<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> *uri</code></em>,
 
366
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
 
367
                             <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
368
368
<p>Creates a new <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> for connecting to the given
369
369
<em class="parameter"><code>uri</code></em>
370
 
. May fail and return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case parsing <em class="parameter"><code>uri</code></em>
 
370
. May fail and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case parsing <em class="parameter"><code>uri</code></em>
371
371
 fails.</p>
372
372
<p>Using this rather than <a class="link" href="GNetworkAddress.html#g-network-address-new" title="g_network_address_new ()"><code class="function">g_network_address_new()</code></a> or
373
373
<a class="link" href="GNetworkAddress.html#g-network-address-parse" title="g_network_address_parse ()"><code class="function">g_network_address_parse()</code></a> allows <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> to determine
393
393
</tr>
394
394
<tr>
395
395
<td class="parameter_name"><p>error</p></td>
396
 
<td class="parameter_description"><p>a pointer to a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 
396
<td class="parameter_description"><p>a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
397
397
<td class="parameter_annotations"> </td>
398
398
</tr>
399
399
</tbody>
401
401
</div>
402
402
<div class="refsect3">
403
403
<a name="id-1.4.16.6.10.7.7"></a><h4>Returns</h4>
404
 
<p> the new <a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
 
404
<p> the new <a class="link" href="GNetworkAddress.html" title="GNetworkAddress"><span class="type">GNetworkAddress</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
405
405
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
406
406
</div>
407
407
<p class="since">Since 2.26</p>
420
420
<a name="GNetworkAddress.property-details"></a><h2>Property Details</h2>
421
421
<div class="refsect2">
422
422
<a name="GNetworkAddress--hostname"></a><h3>The <code class="literal">“hostname”</code> property</h3>
423
 
<pre class="programlisting">  “hostname”                 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
423
<pre class="programlisting">  “hostname”                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
424
424
<p>Hostname to resolve.</p>
425
425
<p>Flags: Read / Write / Construct Only</p>
426
426
<p>Default value: NULL</p>
428
428
<hr>
429
429
<div class="refsect2">
430
430
<a name="GNetworkAddress--port"></a><h3>The <code class="literal">“port”</code> property</h3>
431
 
<pre class="programlisting">  “port”                     <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
 
431
<pre class="programlisting">  “port”                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
432
432
<p>Network port.</p>
433
433
<p>Flags: Read / Write / Construct Only</p>
434
434
<p>Allowed values: &lt;= 65535</p>
437
437
<hr>
438
438
<div class="refsect2">
439
439
<a name="GNetworkAddress--scheme"></a><h3>The <code class="literal">“scheme”</code> property</h3>
440
 
<pre class="programlisting">  “scheme”                   <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
440
<pre class="programlisting">  “scheme”                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
441
441
<p>URI Scheme.</p>
442
442
<p>Flags: Read / Write / Construct Only</p>
443
443
<p>Default value: NULL</p>