Imported Upstream version 2.50.2
[platform/upstream/glib.git] / docs / reference / gio / html / GInetAddressMask.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GInetAddressMask: GIO Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="networking.html" title="Low-level network support">
9 <link rel="prev" href="GInetAddress.html" title="GInetAddress">
10 <link rel="next" href="GSocketAddress.html" title="GSocketAddress">
11 <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18                   <a href="#GInetAddressMask.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
19                   <a href="#GInetAddressMask.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
20                   <a href="#GInetAddressMask.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
21                   <a href="#GInetAddressMask.properties" class="shortcut">Properties</a></span>
22 </td>
23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24 <td><a accesskey="u" href="networking.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25 <td><a accesskey="p" href="GInetAddress.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26 <td><a accesskey="n" href="GSocketAddress.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27 </tr></table>
28 <div class="refentry">
29 <a name="GInetAddressMask"></a><div class="titlepage"></div>
30 <div class="refnamediv"><table width="100%"><tr>
31 <td valign="top">
32 <h2><span class="refentrytitle"><a name="GInetAddressMask.top_of_page"></a>GInetAddressMask</span></h2>
33 <p>GInetAddressMask — An IPv4/IPv6 address mask</p>
34 </td>
35 <td class="gallery_image" valign="top" align="right"></td>
36 </tr></table></div>
37 <div class="refsect1">
38 <a name="GInetAddressMask.functions"></a><h2>Functions</h2>
39 <div class="informaltable"><table class="informaltable" width="100%" border="0">
40 <colgroup>
41 <col width="150px" class="functions_return">
42 <col class="functions_name">
43 </colgroup>
44 <tbody>
45 <tr>
46 <td class="function_type">
47 <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="returnvalue">GInetAddressMask</span></a> *
48 </td>
49 <td class="function_name">
50 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-new" title="g_inet_address_mask_new ()">g_inet_address_mask_new</a> <span class="c_punctuation">()</span>
51 </td>
52 </tr>
53 <tr>
54 <td class="function_type">
55 <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="returnvalue">GInetAddressMask</span></a> *
56 </td>
57 <td class="function_name">
58 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-new-from-string" title="g_inet_address_mask_new_from_string ()">g_inet_address_mask_new_from_string</a> <span class="c_punctuation">()</span>
59 </td>
60 </tr>
61 <tr>
62 <td class="function_type">
63 <a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
64 </td>
65 <td class="function_name">
66 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-to-string" title="g_inet_address_mask_to_string ()">g_inet_address_mask_to_string</a> <span class="c_punctuation">()</span>
67 </td>
68 </tr>
69 <tr>
70 <td class="function_type">
71 <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="returnvalue">GSocketFamily</span></a>
72 </td>
73 <td class="function_name">
74 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-get-family" title="g_inet_address_mask_get_family ()">g_inet_address_mask_get_family</a> <span class="c_punctuation">()</span>
75 </td>
76 </tr>
77 <tr>
78 <td class="function_type">
79 <a class="link" href="GInetAddress.html" title="GInetAddress"><span class="returnvalue">GInetAddress</span></a> *
80 </td>
81 <td class="function_name">
82 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-get-address" title="g_inet_address_mask_get_address ()">g_inet_address_mask_get_address</a> <span class="c_punctuation">()</span>
83 </td>
84 </tr>
85 <tr>
86 <td class="function_type">
87 <a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
88 </td>
89 <td class="function_name">
90 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-get-length" title="g_inet_address_mask_get_length ()">g_inet_address_mask_get_length</a> <span class="c_punctuation">()</span>
91 </td>
92 </tr>
93 <tr>
94 <td class="function_type">
95 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
96 </td>
97 <td class="function_name">
98 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-matches" title="g_inet_address_mask_matches ()">g_inet_address_mask_matches</a> <span class="c_punctuation">()</span>
99 </td>
100 </tr>
101 <tr>
102 <td class="function_type">
103 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
104 </td>
105 <td class="function_name">
106 <a class="link" href="GInetAddressMask.html#g-inet-address-mask-equal" title="g_inet_address_mask_equal ()">g_inet_address_mask_equal</a> <span class="c_punctuation">()</span>
107 </td>
108 </tr>
109 </tbody>
110 </table></div>
111 </div>
112 <div class="refsect1">
113 <a name="GInetAddressMask.properties"></a><h2>Properties</h2>
114 <div class="informaltable"><table class="informaltable" border="0">
115 <colgroup>
116 <col width="150px" class="properties_type">
117 <col width="300px" class="properties_name">
118 <col width="200px" class="properties_flags">
119 </colgroup>
120 <tbody>
121 <tr>
122 <td class="property_type">
123 <a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *</td>
124 <td class="property_name"><a class="link" href="GInetAddressMask.html#GInetAddressMask--address" title="The “address” property">address</a></td>
125 <td class="property_flags">Read / Write</td>
126 </tr>
127 <tr>
128 <td class="property_type"><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></td>
129 <td class="property_name"><a class="link" href="GInetAddressMask.html#GInetAddressMask--family" title="The “family” property">family</a></td>
130 <td class="property_flags">Read</td>
131 </tr>
132 <tr>
133 <td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
134 <td class="property_name"><a class="link" href="GInetAddressMask.html#GInetAddressMask--length" title="The “length” property">length</a></td>
135 <td class="property_flags">Read / Write</td>
136 </tr>
137 </tbody>
138 </table></div>
139 </div>
140 <div class="refsect1">
141 <a name="GInetAddressMask.other"></a><h2>Types and Values</h2>
142 <div class="informaltable"><table class="informaltable" width="100%" border="0">
143 <colgroup>
144 <col width="150px" class="name">
145 <col class="description">
146 </colgroup>
147 <tbody><tr>
148 <td class="datatype_keyword"> </td>
149 <td class="function_name"><a class="link" href="GInetAddressMask.html#GInetAddressMask-struct" title="GInetAddressMask">GInetAddressMask</a></td>
150 </tr></tbody>
151 </table></div>
152 </div>
153 <div class="refsect1">
154 <a name="GInetAddressMask.object-hierarchy"></a><h2>Object Hierarchy</h2>
155 <pre class="screen">    <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
156     <span class="lineart">╰──</span> GInetAddressMask
157 </pre>
158 </div>
159 <div class="refsect1">
160 <a name="GInetAddressMask.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
161 <p>
162 GInetAddressMask implements
163  <a class="link" href="GInitable.html" title="GInitable">GInitable</a>.</p>
164 </div>
165 <div class="refsect1">
166 <a name="GInetAddressMask.includes"></a><h2>Includes</h2>
167 <pre class="synopsis">#include &lt;gio/gio.h&gt;
168 </pre>
169 </div>
170 <div class="refsect1">
171 <a name="GInetAddressMask.description"></a><h2>Description</h2>
172 <p><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> represents a range of IPv4 or IPv6 addresses
173 described by a base address and a length indicating how many bits
174 of the base address are relevant for matching purposes. These are
175 often given in string form. Eg, "10.0.0.0/8", or "fe80::/10".</p>
176 </div>
177 <div class="refsect1">
178 <a name="GInetAddressMask.functions_details"></a><h2>Functions</h2>
179 <div class="refsect2">
180 <a name="g-inet-address-mask-new"></a><h3>g_inet_address_mask_new ()</h3>
181 <pre class="programlisting"><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="returnvalue">GInetAddressMask</span></a> *
182 g_inet_address_mask_new (<em class="parameter"><code><a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *addr</code></em>,
183                          <em class="parameter"><code><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a> length</code></em>,
184                          <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
185 <p>Creates a new <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> representing all addresses whose
186 first <em class="parameter"><code>length</code></em>
187  bits match <em class="parameter"><code>addr</code></em>
188 .</p>
189 <div class="refsect3">
190 <a name="g-inet-address-mask-new.parameters"></a><h4>Parameters</h4>
191 <div class="informaltable"><table class="informaltable" width="100%" border="0">
192 <colgroup>
193 <col width="150px" class="parameters_name">
194 <col class="parameters_description">
195 <col width="200px" class="parameters_annotations">
196 </colgroup>
197 <tbody>
198 <tr>
199 <td class="parameter_name"><p>addr</p></td>
200 <td class="parameter_description"><p>a <a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a></p></td>
201 <td class="parameter_annotations"> </td>
202 </tr>
203 <tr>
204 <td class="parameter_name"><p>length</p></td>
205 <td class="parameter_description"><p>number of bits of <em class="parameter"><code>addr</code></em>
206 to use</p></td>
207 <td class="parameter_annotations"> </td>
208 </tr>
209 <tr>
210 <td class="parameter_name"><p>error</p></td>
211 <td class="parameter_description"><p>return location for <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
212 <td class="parameter_annotations"> </td>
213 </tr>
214 </tbody>
215 </table></div>
216 </div>
217 <div class="refsect3">
218 <a name="g-inet-address-mask-new.returns"></a><h4>Returns</h4>
219 <p> a new <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</p>
220 </div>
221 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
222 </div>
223 <hr>
224 <div class="refsect2">
225 <a name="g-inet-address-mask-new-from-string"></a><h3>g_inet_address_mask_new_from_string ()</h3>
226 <pre class="programlisting"><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="returnvalue">GInetAddressMask</span></a> *
227 g_inet_address_mask_new_from_string (<em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mask_string</code></em>,
228                                      <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
229 <p>Parses <em class="parameter"><code>mask_string</code></em>
230  as an IP address and (optional) length, and
231 creates a new <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a>. The length, if present, is
232 delimited by a "/". If it is not present, then the length is
233 assumed to be the full length of the address.</p>
234 <div class="refsect3">
235 <a name="g-inet-address-mask-new-from-string.parameters"></a><h4>Parameters</h4>
236 <div class="informaltable"><table class="informaltable" width="100%" border="0">
237 <colgroup>
238 <col width="150px" class="parameters_name">
239 <col class="parameters_description">
240 <col width="200px" class="parameters_annotations">
241 </colgroup>
242 <tbody>
243 <tr>
244 <td class="parameter_name"><p>mask_string</p></td>
245 <td class="parameter_description"><p>an IP address or address/length string</p></td>
246 <td class="parameter_annotations"> </td>
247 </tr>
248 <tr>
249 <td class="parameter_name"><p>error</p></td>
250 <td class="parameter_description"><p>return location for <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
251 <td class="parameter_annotations"> </td>
252 </tr>
253 </tbody>
254 </table></div>
255 </div>
256 <div class="refsect3">
257 <a name="g-inet-address-mask-new-from-string.returns"></a><h4>Returns</h4>
258 <p> a new <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> corresponding to <em class="parameter"><code>string</code></em>
259 , or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
260 on error.</p>
261 </div>
262 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
263 </div>
264 <hr>
265 <div class="refsect2">
266 <a name="g-inet-address-mask-to-string"></a><h3>g_inet_address_mask_to_string ()</h3>
267 <pre class="programlisting"><a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
268 g_inet_address_mask_to_string (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>);</pre>
269 <p>Converts <em class="parameter"><code>mask</code></em>
270  back to its corresponding string form.</p>
271 <div class="refsect3">
272 <a name="g-inet-address-mask-to-string.parameters"></a><h4>Parameters</h4>
273 <div class="informaltable"><table class="informaltable" width="100%" border="0">
274 <colgroup>
275 <col width="150px" class="parameters_name">
276 <col class="parameters_description">
277 <col width="200px" class="parameters_annotations">
278 </colgroup>
279 <tbody><tr>
280 <td class="parameter_name"><p>mask</p></td>
281 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
282 <td class="parameter_annotations"> </td>
283 </tr></tbody>
284 </table></div>
285 </div>
286 <div class="refsect3">
287 <a name="g-inet-address-mask-to-string.returns"></a><h4>Returns</h4>
288 <p> a string corresponding to <em class="parameter"><code>mask</code></em>
289 .</p>
290 </div>
291 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
292 </div>
293 <hr>
294 <div class="refsect2">
295 <a name="g-inet-address-mask-get-family"></a><h3>g_inet_address_mask_get_family ()</h3>
296 <pre class="programlisting"><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="returnvalue">GSocketFamily</span></a>
297 g_inet_address_mask_get_family (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>);</pre>
298 <p>Gets the <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a> of <em class="parameter"><code>mask</code></em>
299 's address</p>
300 <div class="refsect3">
301 <a name="g-inet-address-mask-get-family.parameters"></a><h4>Parameters</h4>
302 <div class="informaltable"><table class="informaltable" width="100%" border="0">
303 <colgroup>
304 <col width="150px" class="parameters_name">
305 <col class="parameters_description">
306 <col width="200px" class="parameters_annotations">
307 </colgroup>
308 <tbody><tr>
309 <td class="parameter_name"><p>mask</p></td>
310 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
311 <td class="parameter_annotations"> </td>
312 </tr></tbody>
313 </table></div>
314 </div>
315 <div class="refsect3">
316 <a name="g-inet-address-mask-get-family.returns"></a><h4>Returns</h4>
317 <p> the <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a> of <em class="parameter"><code>mask</code></em>
318 's address</p>
319 </div>
320 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
321 </div>
322 <hr>
323 <div class="refsect2">
324 <a name="g-inet-address-mask-get-address"></a><h3>g_inet_address_mask_get_address ()</h3>
325 <pre class="programlisting"><a class="link" href="GInetAddress.html" title="GInetAddress"><span class="returnvalue">GInetAddress</span></a> *
326 g_inet_address_mask_get_address (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>);</pre>
327 <p>Gets <em class="parameter"><code>mask</code></em>
328 's base address</p>
329 <div class="refsect3">
330 <a name="g-inet-address-mask-get-address.parameters"></a><h4>Parameters</h4>
331 <div class="informaltable"><table class="informaltable" width="100%" border="0">
332 <colgroup>
333 <col width="150px" class="parameters_name">
334 <col class="parameters_description">
335 <col width="200px" class="parameters_annotations">
336 </colgroup>
337 <tbody><tr>
338 <td class="parameter_name"><p>mask</p></td>
339 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
340 <td class="parameter_annotations"> </td>
341 </tr></tbody>
342 </table></div>
343 </div>
344 <div class="refsect3">
345 <a name="g-inet-address-mask-get-address.returns"></a><h4>Returns</h4>
346 <p> <em class="parameter"><code>mask</code></em>
347 's base address. </p>
348 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
349 </div>
350 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
351 </div>
352 <hr>
353 <div class="refsect2">
354 <a name="g-inet-address-mask-get-length"></a><h3>g_inet_address_mask_get_length ()</h3>
355 <pre class="programlisting"><a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
356 g_inet_address_mask_get_length (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>);</pre>
357 <p>Gets <em class="parameter"><code>mask</code></em>
358 's length</p>
359 <div class="refsect3">
360 <a name="g-inet-address-mask-get-length.parameters"></a><h4>Parameters</h4>
361 <div class="informaltable"><table class="informaltable" width="100%" border="0">
362 <colgroup>
363 <col width="150px" class="parameters_name">
364 <col class="parameters_description">
365 <col width="200px" class="parameters_annotations">
366 </colgroup>
367 <tbody><tr>
368 <td class="parameter_name"><p>mask</p></td>
369 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
370 <td class="parameter_annotations"> </td>
371 </tr></tbody>
372 </table></div>
373 </div>
374 <div class="refsect3">
375 <a name="g-inet-address-mask-get-length.returns"></a><h4>Returns</h4>
376 <p> <em class="parameter"><code>mask</code></em>
377 's length</p>
378 </div>
379 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
380 </div>
381 <hr>
382 <div class="refsect2">
383 <a name="g-inet-address-mask-matches"></a><h3>g_inet_address_mask_matches ()</h3>
384 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
385 g_inet_address_mask_matches (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>,
386                              <em class="parameter"><code><a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *address</code></em>);</pre>
387 <p>Tests if <em class="parameter"><code>address</code></em>
388  falls within the range described by <em class="parameter"><code>mask</code></em>
389 .</p>
390 <div class="refsect3">
391 <a name="g-inet-address-mask-matches.parameters"></a><h4>Parameters</h4>
392 <div class="informaltable"><table class="informaltable" width="100%" border="0">
393 <colgroup>
394 <col width="150px" class="parameters_name">
395 <col class="parameters_description">
396 <col width="200px" class="parameters_annotations">
397 </colgroup>
398 <tbody>
399 <tr>
400 <td class="parameter_name"><p>mask</p></td>
401 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
402 <td class="parameter_annotations"> </td>
403 </tr>
404 <tr>
405 <td class="parameter_name"><p>address</p></td>
406 <td class="parameter_description"><p>a <a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a></p></td>
407 <td class="parameter_annotations"> </td>
408 </tr>
409 </tbody>
410 </table></div>
411 </div>
412 <div class="refsect3">
413 <a name="g-inet-address-mask-matches.returns"></a><h4>Returns</h4>
414 <p> whether <em class="parameter"><code>address</code></em>
415 falls within the range described by
416 <em class="parameter"><code>mask</code></em>
417 .</p>
418 </div>
419 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
420 </div>
421 <hr>
422 <div class="refsect2">
423 <a name="g-inet-address-mask-equal"></a><h3>g_inet_address_mask_equal ()</h3>
424 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
425 g_inet_address_mask_equal (<em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask</code></em>,
426                            <em class="parameter"><code><a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a> *mask2</code></em>);</pre>
427 <p>Tests if <em class="parameter"><code>mask</code></em>
428  and <em class="parameter"><code>mask2</code></em>
429  are the same mask.</p>
430 <div class="refsect3">
431 <a name="g-inet-address-mask-equal.parameters"></a><h4>Parameters</h4>
432 <div class="informaltable"><table class="informaltable" width="100%" border="0">
433 <colgroup>
434 <col width="150px" class="parameters_name">
435 <col class="parameters_description">
436 <col width="200px" class="parameters_annotations">
437 </colgroup>
438 <tbody>
439 <tr>
440 <td class="parameter_name"><p>mask</p></td>
441 <td class="parameter_description"><p>a <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
442 <td class="parameter_annotations"> </td>
443 </tr>
444 <tr>
445 <td class="parameter_name"><p>mask2</p></td>
446 <td class="parameter_description"><p>another <a class="link" href="GInetAddressMask.html" title="GInetAddressMask"><span class="type">GInetAddressMask</span></a></p></td>
447 <td class="parameter_annotations"> </td>
448 </tr>
449 </tbody>
450 </table></div>
451 </div>
452 <div class="refsect3">
453 <a name="g-inet-address-mask-equal.returns"></a><h4>Returns</h4>
454 <p> whether <em class="parameter"><code>mask</code></em>
455 and <em class="parameter"><code>mask2</code></em>
456 are the same mask</p>
457 </div>
458 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
459 </div>
460 </div>
461 <div class="refsect1">
462 <a name="GInetAddressMask.other_details"></a><h2>Types and Values</h2>
463 <div class="refsect2">
464 <a name="GInetAddressMask-struct"></a><h3>GInetAddressMask</h3>
465 <pre class="programlisting">typedef struct _GInetAddressMask GInetAddressMask;</pre>
466 <p>A combination of an IPv4 or IPv6 base address and a length,
467 representing a range of IP addresses.</p>
468 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
469 </div>
470 </div>
471 <div class="refsect1">
472 <a name="GInetAddressMask.property-details"></a><h2>Property Details</h2>
473 <div class="refsect2">
474 <a name="GInetAddressMask--address"></a><h3>The <code class="literal">“address”</code> property</h3>
475 <pre class="programlisting">  “address”                  <a class="link" href="GInetAddress.html" title="GInetAddress"><span class="type">GInetAddress</span></a> *</pre>
476 <p>The base address.</p>
477 <p>Flags: Read / Write</p>
478 </div>
479 <hr>
480 <div class="refsect2">
481 <a name="GInetAddressMask--family"></a><h3>The <code class="literal">“family”</code> property</h3>
482 <pre class="programlisting">  “family”                   <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></pre>
483 <p>The address family (IPv4 or IPv6).</p>
484 <p>Flags: Read</p>
485 <p>Default value: G_SOCKET_FAMILY_INVALID</p>
486 </div>
487 <hr>
488 <div class="refsect2">
489 <a name="GInetAddressMask--length"></a><h3>The <code class="literal">“length”</code> property</h3>
490 <pre class="programlisting">  “length”                   <a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
491 <p>The prefix length.</p>
492 <p>Flags: Read / Write</p>
493 <p>Allowed values: &lt;= 128</p>
494 <p>Default value: 0</p>
495 </div>
496 </div>
497 </div>
498 <div class="footer">
499 <hr>Generated by GTK-Doc V1.25.1</div>
500 </body>
501 </html>