RubyGems - glib2 - Versions diffs - 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32 - Mend

glib2 2.2.5-x64-mingw32 → 3.0.0-x64-mingw32

Files changed (1979) hide show

data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GIO Reference Manual: GInetSocketAddress</title>
+<title>GInetSocketAddress: GIO Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="networking.html" title="Low-level network support">

data/vendor/local/share/gtk-doc/html/gio/GInitable.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GIO Reference Manual: GInitable</title>
+<title>GInitable: GIO Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="failable_initialization.html" title="Failable Initialization">
@@ -119,7 +119,7 @@ GInitable is required by
 <a name="GInitable.implementations"></a><h2>Known Implementations</h2>
 <p>
 GInitable is implemented by
- <a class="link" href="GCharsetConverter.html" title="GCharsetConverter">GCharsetConverter</a>,  <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>,  <a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</a>,  <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>,  <a class="link" href="GDBusServer.html" title="GDBusServer">GDBusServer</a>,  <a class="link" href="GSocket.html" title="GSocket">GSocket</a> and  <a class="link" href="GSubprocess.html" title="GSubprocess">GSubprocess</a>.</p>
+ <a class="link" href="GCharsetConverter.html" title="GCharsetConverter">GCharsetConverter</a>,  <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>,  <a class="link" href="GDBusObjectManagerClient.html" title="GDBusObjectManagerClient">GDBusObjectManagerClient</a>,  <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>,  <a class="link" href="GDBusServer.html" title="GDBusServer">GDBusServer</a>,  <a class="link" href="GInetAddressMask.html" title="GInetAddressMask">GInetAddressMask</a>,  <a class="link" href="GSocket.html" title="GSocket">GSocket</a> and  <a class="link" href="GSubprocess.html" title="GSubprocess">GSubprocess</a>.</p>
 </div>
 <div class="refsect1">
 <a name="GInitable.includes"></a><h2>Includes</h2>

data/vendor/local/share/gtk-doc/html/gio/GInputStream.html CHANGED

@@ -2,7 +2,7 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GIO Reference Manual: GInputStream</title>
+<title>GInputStream: GIO Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GIO Reference Manual">
 <link rel="up" href="streaming.html" title="Streaming I/O">
@@ -59,6 +59,22 @@
 </tr>
 <tr>
 <td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="GInputStream.html#g-input-stream-read-all-async" title="g_input_stream_read_all_async ()">g_input_stream_read_all_async</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GInputStream.html#g-input-stream-read-all-finish" title="g_input_stream_read_all_finish ()">g_input_stream_read_all_finish</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
 <a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
 </td>
 <td class="function_name">
@@ -325,12 +341,17 @@ read into <em class="parameter"><code>buffer</code></em>
 .</p>
 <p>If there is an error during the operation <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and <em class="parameter"><code>error</code></em>
-is set to indicate the error status, <em class="parameter"><code>bytes_read</code></em>
- is updated to contain
-the number of bytes read into <em class="parameter"><code>buffer</code></em>
- before the error occurred.</p>
+is set to indicate the error status.</p>
+<p>As a special exception to the normal conventions for functions that
+use <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, if this function returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (and sets <em class="parameter"><code>error</code></em>
+) then
+<em class="parameter"><code>bytes_read</code></em>
+ will be set to the number of bytes that were successfully
+read before the error was encountered.  This functionality is only
+available from C.  If you need it from another language then you must
+write your own loop around <a class="link" href="GInputStream.html#g-input-stream-read" title="g_input_stream_read ()"><code class="function">g_input_stream_read()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.3.8"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.3.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -373,13 +394,140 @@ read data into (which should be at least count bytes long). </p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.3.9"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.3.10"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there was an error</p>
 <p></p>
 </div>
 </div>
 <hr>
 <div class="refsect2">
+<a name="g-input-stream-read-all-async"></a><h3>g_input_stream_read_all_async ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+g_input_stream_read_all_async (<em class="parameter"><code><a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> *stream</code></em>,
+                               <em class="parameter"><code><span class="type">void</span> *buffer</code></em>,
+                               <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> count</code></em>,
+                               <em class="parameter"><code><span class="type">int</span> io_priority</code></em>,
+                               <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
+                               <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
+                               <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+<p>Request an asynchronous read of <em class="parameter"><code>count</code></em>
+ bytes from the stream into the
+buffer starting at <em class="parameter"><code>buffer</code></em>
+.</p>
+<p>This is the asynchronous equivalent of <a class="link" href="GInputStream.html#g-input-stream-read-all" title="g_input_stream_read_all ()"><code class="function">g_input_stream_read_all()</code></a>.</p>
+<p>Call <a class="link" href="GInputStream.html#g-input-stream-read-all-finish" title="g_input_stream_read_all_finish ()"><code class="function">g_input_stream_read_all_finish()</code></a> to collect the result.</p>
+<p>Any outstanding I/O request with higher priority (lower numerical
+value) will be executed before an outstanding request with lower
+priority. Default priority is <a href="../glib/glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CAPS"><code class="literal">G_PRIORITY_DEFAULT</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.7.3.9.4.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>stream</p></td>
+<td class="parameter_description"><p>A <a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>buffer</p></td>
+<td class="parameter_description"><p> a buffer to
+read data into (which should be at least count bytes long). </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=count][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>count</p></td>
+<td class="parameter_description"><p>the number of bytes that will be read from the stream</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>io_priority</p></td>
+<td class="parameter_description"><p>the <a class="link" href="GAsyncResult.html#io-priority" title="I/O Priority">I/O priority</a> of the request</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>callback</p></td>
+<td class="parameter_description"><p> callback to call when the request is satisfied. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p> the data to pass to callback function. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-input-stream-read-all-finish"></a><h3>g_input_stream_read_all_finish ()</h3>
+<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+g_input_stream_read_all_finish (<em class="parameter"><code><a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> *stream</code></em>,
+                                <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
+                                <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *bytes_read</code></em>,
+                                <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
+<p>Finishes an asynchronous stream read operation started with
+<a class="link" href="GInputStream.html#g-input-stream-read-all-async" title="g_input_stream_read_all_async ()"><code class="function">g_input_stream_read_all_async()</code></a>.</p>
+<p>As a special exception to the normal conventions for functions that
+use <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, if this function returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (and sets <em class="parameter"><code>error</code></em>
+) then
+<em class="parameter"><code>bytes_read</code></em>
+ will be set to the number of bytes that were successfully
+read before the error was encountered.  This functionality is only
+available from C.  If you need it from another language then you must
+write your own loop around <a class="link" href="GInputStream.html#g-input-stream-read-async" title="g_input_stream_read_async ()"><code class="function">g_input_stream_read_async()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.7.3.9.5.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>stream</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>result</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>bytes_read</p></td>
+<td class="parameter_description"><p> location to store the number of bytes that was read from the stream. </p></td>
+<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>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.7.3.9.5.7"></a><h4>Returns</h4>
+<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there was an error</p>
+<p></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="g-input-stream-skip"></a><h3>g_input_stream_skip ()</h3>
 <pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gssize"><span class="returnvalue">gssize</span></a>
 g_input_stream_skip (<em class="parameter"><code><a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> *stream</code></em>,
@@ -400,7 +548,7 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
 operation was partially finished when the operation was cancelled the
 partial result will be returned, without an error.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.4.8"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.6.8"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -432,7 +580,7 @@ partial result will be returned, without an error.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.4.9"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.6.9"></a><h4>Returns</h4>
 <p> Number of bytes skipped, or -1 on error</p>
 <p></p>
 </div>
@@ -464,7 +612,7 @@ was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANC
 Cancelling a close will still leave the stream closed, but some streams
 can use a faster close that doesn't block to e.g. check errors.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.5.10"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.7.10"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -491,7 +639,7 @@ can use a faster close that doesn't block to e.g. check errors.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.5.11"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.7.11"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure</p>
 <p></p>
 </div>
@@ -532,7 +680,7 @@ priority is <a href="../glib/glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CA
 asynchronicity, so they are optional for inheriting classes. However, if you
 override one you must override all.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.6.10"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.8.10"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -590,7 +738,7 @@ g_input_stream_read_finish (<em class="parameter"><code><a class="link" href="GI
                             <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Finishes an asynchronous stream read operation.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.7.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.9.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -618,7 +766,7 @@ ignore.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.7.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.9.6"></a><h4>Returns</h4>
 <p> number of bytes read in, or -1 on error, or 0 on end of file.</p>
 <p></p>
 </div>
@@ -656,7 +804,7 @@ Default priority is <a href="../glib/glib-The-Main-Event-Loop.html#G-PRIORITY-DE
 implement asynchronicity, so they are optional for inheriting classes.
 However, if you override one, you must override all.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.8.10"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.10.10"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -707,7 +855,7 @@ g_input_stream_skip_finish (<em class="parameter"><code><a class="link" href="GI
                             <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Finishes a stream skip operation.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.9.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.11.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -735,7 +883,7 @@ ignore.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.9.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.11.6"></a><h4>Returns</h4>
 <p> the size of the bytes skipped, or <code class="literal">-1</code> on error.</p>
 <p></p>
 </div>
@@ -759,7 +907,7 @@ operation.</p>
 asynchronicity, so they are optional for inheriting classes. However, if you
 override one you must override all.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.10.7"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.12.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -805,7 +953,7 @@ g_input_stream_close_finish (<em class="parameter"><code><a class="link" href="G
                              <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Finishes closing a stream asynchronously, started from <a class="link" href="GInputStream.html#g-input-stream-close-async" title="g_input_stream_close_async ()"><code class="function">g_input_stream_close_async()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.11.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.13.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -833,7 +981,7 @@ ignore.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.11.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.13.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the stream was closed successfully.</p>
 <p></p>
 </div>
@@ -845,7 +993,7 @@ ignore.</p></td>
 g_input_stream_is_closed (<em class="parameter"><code><a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> *stream</code></em>);</pre>
 <p>Checks if an input stream is closed.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.12.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.14.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -860,7 +1008,7 @@ g_input_stream_is_closed (<em class="parameter"><code><a class="link" href="GInp
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.12.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.14.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the stream is closed.</p>
 <p></p>
 </div>
@@ -872,7 +1020,7 @@ g_input_stream_is_closed (<em class="parameter"><code><a class="link" href="GInp
 g_input_stream_has_pending (<em class="parameter"><code><a class="link" href="GInputStream.html" title="GInputStream"><span class="type">GInputStream</span></a> *stream</code></em>);</pre>
 <p>Checks if an input stream has pending actions.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.13.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.15.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -887,7 +1035,7 @@ g_input_stream_has_pending (<em class="parameter"><code><a class="link" href="GI
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.13.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.15.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>stream</code></em>
 has pending actions.</p>
 <p></p>
@@ -906,7 +1054,7 @@ already set or <em class="parameter"><code>stream</code></em>
 <em class="parameter"><code>error</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.14.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.16.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -929,7 +1077,7 @@ ignore.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.14.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.16.6"></a><h4>Returns</h4>
 <p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if pending was previously unset and is now set.</p>
 <p></p>
 </div>
@@ -942,7 +1090,7 @@ g_input_stream_clear_pending (<em class="parameter"><code><a class="link" href="
 <p>Clears the pending flag on <em class="parameter"><code>stream</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.15.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.17.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -990,7 +1138,7 @@ partial result will be returned, without an error.</p>
 <p>On error <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
  is set accordingly.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.16.9"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.18.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1023,7 +1171,7 @@ values include 4096 and 8192.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.16.10"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.18.10"></a><h4>Returns</h4>
 <p> a new <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</p>
 <p></p>
 </div>
@@ -1061,7 +1209,7 @@ many bytes as requested. Zero is returned on end of file (or if
 value) will be executed before an outstanding request with lower
 priority. Default priority is <a href="../glib/glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT:CAPS"><code class="literal">G_PRIORITY_DEFAULT</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.17.9"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.19.9"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1113,7 +1261,7 @@ g_input_stream_read_bytes_finish (<em class="parameter"><code><a class="link" hr
                                   <em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>Finishes an asynchronous stream read-into-<a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a> operation.</p>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.18.5"></a><h4>Parameters</h4>
+<a name="id-1.4.7.3.9.20.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1141,7 +1289,7 @@ ignore.</p></td>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.4.7.3.9.18.6"></a><h4>Returns</h4>
+<a name="id-1.4.7.3.9.20.6"></a><h4>Returns</h4>
 <p> the newly-allocated <a href="../glib/glib-Byte-Arrays.html#GBytes"><span class="type">GBytes</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error</p>
 <p></p>
 </div>

data/vendor/local/share/gtk-doc/html/gio/GListModel.html ADDED

@@ -0,0 +1,532 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GListModel: GIO Reference Manual</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="GIO Reference Manual">
+<link rel="up" href="data-models.html" title="Data Models">
+<link rel="prev" href="data-models.html" title="Data Models">
+<link rel="next" href="GListStore.html" title="GListStore">
+<meta name="generator" content="GTK-Doc V1.21.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts">
+<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span>
+                  <a href="#GListModel.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span>
+                  <a href="#GListModel.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span>
+                  <a href="#GListModel.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_implementations">  <span class="dim">|</span>
+                  <a href="#GListModel.implementations" class="shortcut">Known Implementations</a></span><span id="nav_signals">  <span class="dim">|</span>
+                  <a href="#GListModel.signals" class="shortcut">Signals</a></span>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="data-models.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="data-models.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GListStore.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="refentry">
+<a name="GListModel"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GListModel.top_of_page"></a>GListModel</span></h2>
+<p>GListModel — An interface describing a dynamic list of objects</p>
+</td>
+<td class="gallery_image" valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsect1">
+<a name="GListModel.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_return">
+<col class="functions_name">
+</colgroup>
+<tbody>
+<tr>
+<td class="function_type">
+<a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GListModel.html#g-list-model-get-item-type" title="g_list_model_get_item_type ()">g_list_model_get_item_type</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GListModel.html#g-list-model-get-n-items" title="g_list_model_get_n_items ()">g_list_model_get_n_items</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="../glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GListModel.html#g-list-model-get-item" title="g_list_model_get_item ()">g_list_model_get_item</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *
+</td>
+<td class="function_name">
+<a class="link" href="GListModel.html#g-list-model-get-object" title="g_list_model_get_object ()">g_list_model_get_object</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="GListModel.html#g-list-model-items-changed" title="g_list_model_items_changed ()">g_list_model_items_changed</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="GListModel.signals"></a><h2>Signals</h2>
+<div class="informaltable"><table border="0">
+<colgroup>
+<col width="150px" class="signals_return">
+<col width="300px" class="signals_name">
+<col width="200px" class="signals_flags">
+</colgroup>
+<tbody><tr>
+<td class="signal_type"><span class="returnvalue">void</span></td>
+<td class="signal_name"><a class="link" href="GListModel.html#GListModel-items-changed" title="The “items-changed” signal">items-changed</a></td>
+<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="GListModel.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="name">
+<col class="description">
+</colgroup>
+<tbody>
+<tr>
+<td class="datatype_keyword"> </td>
+<td class="function_name"><a class="link" href="GListModel.html#GListModel-struct" title="GListModel">GListModel</a></td>
+</tr>
+<tr>
+<td class="datatype_keyword">struct</td>
+<td class="function_name"><a class="link" href="GListModel.html#GListModelInterface" title="struct GListModelInterface">GListModelInterface</a></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="GListModel.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="screen">    GInterface
+    <span class="lineart">╰──</span> GListModel
+</pre>
+</div>
+<div class="refsect1">
+<a name="GListModel.prerequisites"></a><h2>Prerequisites</h2>
+<p>
+GListModel requires
+ <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GListModel.implementations"></a><h2>Known Implementations</h2>
+<p>
+GListModel is implemented by
+ <a class="link" href="GListStore.html" title="GListStore">GListStore</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GListModel.includes"></a><h2>Includes</h2>
+<pre class="synopsis">#include &lt;gio/gio.h&gt;
+</pre>
+</div>
+<div class="refsect1">
+<a name="GListModel.description"></a><h2>Description</h2>
+<p><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> is an interface that represents a mutable list of
+<a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObjects</span></a>. Its main intention is as a model for various widgets in
+user interfaces, such as list views, but it can also be used as a
+convenient method of returning lists of data, with support for
+updates.</p>
+<p>Each object in the list may also report changes in itself via some
+mechanism (normally the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">“notify”</span></a> signal).  Taken together
+with the <a class="link" href="GListModel.html#GListModel-items-changed" title="The “items-changed” signal"><span class="type">“items-changed”</span></a> signal, this provides for a list
+that can change its membership, and in which the members can change
+their individual properties.</p>
+<p>A good example would be the list of visible wireless network access
+points, where each access point can report dynamic properties such as
+signal strength.</p>
+<p>It is important to note that the <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> itself does not report
+changes to the individual items.  It only reports changes to the list
+membership.  If you want to observe changes to the objects themselves
+then you need to connect signals to the objects that you are
+interested in.</p>
+<p>All items in a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> are of (or derived from) the same type.
+<a class="link" href="GListModel.html#g-list-model-get-item-type" title="g_list_model_get_item_type ()"><code class="function">g_list_model_get_item_type()</code></a> returns that type.  The type may be an
+interface, in which case all objects in the list must implement it.</p>
+<p>The semantics are close to that of an array:
+<code class="function">g_list_model_get_length()</code> returns the number of items in the list and
+<a class="link" href="GListModel.html#g-list-model-get-item" title="g_list_model_get_item ()"><code class="function">g_list_model_get_item()</code></a> returns an item at a (0-based) position. In
+order to allow implementations to calculate the list length lazily,
+you can also iterate over items: starting from 0, repeatedly call
+<a class="link" href="GListModel.html#g-list-model-get-item" title="g_list_model_get_item ()"><code class="function">g_list_model_get_item()</code></a> until it returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+<p>An implementation may create objects lazily, but must take care to
+return the same object for a given position until all references to
+it are gone.</p>
+<p>On the other side, a consumer is expected only to hold references on
+objects that are currently "user visible", in order to faciliate the
+maximum level of laziness in the implementation of the list and to
+reduce the required number of signal connections at a given time.</p>
+<p>This interface is intended only to be used from a single thread.  The
+thread in which it is appropriate to use it depends on the particular
+implementation, but typically it will be from the thread that owns
+the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>
+in effect at the time that the model was created.</p>
+</div>
+<div class="refsect1">
+<a name="GListModel.functions_details"></a><h2>Functions</h2>
+<div class="refsect2">
+<a name="g-list-model-get-item-type"></a><h3>g_list_model_get_item_type ()</h3>
+<pre class="programlisting"><a href="../gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
+g_list_model_get_item_type (<em class="parameter"><code><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list</code></em>);</pre>
+<p>Gets the type of the items in <em class="parameter"><code>list</code></em>
+. All items returned from
+<code class="function">g_list_model_get_type()</code> are of that type or a subtype, or are an
+implementation of that interface.</p>
+<p>The item type of a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> can not change during the life of the
+model.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.2.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.2.7"></a><h4>Returns</h4>
+<p> the <a href="../gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of the items contained in <em class="parameter"><code>list</code></em>
+.</p>
+<p></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-list-model-get-n-items"></a><h3>g_list_model_get_n_items ()</h3>
+<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
+g_list_model_get_n_items (<em class="parameter"><code><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list</code></em>);</pre>
+<p>Gets the number of items in <em class="parameter"><code>list</code></em>
+.</p>
+<p>Depending on the model implementation, calling this function may be
+less efficient than iterating the list with increasing values for
+<em class="parameter"><code>position</code></em>
+ until <a class="link" href="GListModel.html#g-list-model-get-item" title="g_list_model_get_item ()"><code class="function">g_list_model_get_item()</code></a> returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.3.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.3.7"></a><h4>Returns</h4>
+<p> the number of items in <em class="parameter"><code>list</code></em>
+.</p>
+<p></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-list-model-get-item"></a><h3>g_list_model_get_item ()</h3>
+<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a>
+g_list_model_get_item (<em class="parameter"><code><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list</code></em>,
+                       <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> position</code></em>);</pre>
+<p>Get the item at <em class="parameter"><code>position</code></em>
+. If <em class="parameter"><code>position</code></em>
+ is greater than the number of
+items in <em class="parameter"><code>list</code></em>
+, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
+<p><a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is never returned for an index that is smaller than the length
+of the list.  See <a class="link" href="GListModel.html#g-list-model-get-n-items" title="g_list_model_get_n_items ()"><code class="function">g_list_model_get_n_items()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.4.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>position</p></td>
+<td class="parameter_description"><p>the position of the item to fetch</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.4.7"></a><h4>Returns</h4>
+<p> the item at <em class="parameter"><code>position</code></em>
+. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GObject]</span></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-list-model-get-object"></a><h3>g_list_model_get_object ()</h3>
+<pre class="programlisting"><a href="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a> *
+g_list_model_get_object (<em class="parameter"><code><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list</code></em>,
+                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> position</code></em>);</pre>
+<p>Get the item at <em class="parameter"><code>position</code></em>
+. If <em class="parameter"><code>position</code></em>
+ is greater than the number of
+items in <em class="parameter"><code>list</code></em>
+, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
+<p><a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is never returned for an index that is smaller than the length
+of the list.  See <a class="link" href="GListModel.html#g-list-model-get-n-items" title="g_list_model_get_n_items ()"><code class="function">g_list_model_get_n_items()</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.5.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>position</p></td>
+<td class="parameter_description"><p>the position of the item to fetch</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.5.7"></a><h4>Returns</h4>
+<p> the object at <em class="parameter"><code>position</code></em>
+. </p>
+<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="g-list-model-items-changed"></a><h3>g_list_model_items_changed ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+g_list_model_items_changed (<em class="parameter"><code><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list</code></em>,
+                            <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> position</code></em>,
+                            <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> removed</code></em>,
+                            <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> added</code></em>);</pre>
+<p>Emits the <a class="link" href="GListModel.html#GListModel-items-changed" title="The “items-changed” signal"><span class="type">“items-changed”</span></a> signal on <em class="parameter"><code>list</code></em>
+.</p>
+<p>This function should only be called by classes implementing
+<a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a>. It has to be called after the internal representation
+of <em class="parameter"><code>list</code></em>
+ has been updated, because handlers connected to this signal
+might query the new state of the list.</p>
+<p>Implementations must only make changes to the model (as visible to
+its consumer) in places that will not cause problems for that
+consumer.  For models that are driven directly by a write API (such
+as <a class="link" href="GListStore.html" title="GListStore"><span class="type">GListStore</span></a>), changes can be reported in response to uses of that
+API.  For models that represent remote data, changes should only be
+made from a fresh mainloop dispatch.  It is particularly not
+permitted to make changes in response to a call to the <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a>
+consumer API.</p>
+<p>Stated another way: in general, it is assumed that code making a
+series of accesses to the model via the API, without returning to the
+mainloop, and without calling other code, will continue to view the
+same contents of the model.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.11.6.8"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>position</p></td>
+<td class="parameter_description"><p>the position at which <em class="parameter"><code>list</code></em>
+changed</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>removed</p></td>
+<td class="parameter_description"><p>the number of items removed</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>added</p></td>
+<td class="parameter_description"><p>the number of items added</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GListModel.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="GListModel-struct"></a><h3>GListModel</h3>
+<pre class="programlisting">typedef struct _GListModel GListModel;</pre>
+<p><a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> is an opaque data structure and can only be accessed
+using the following functions.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GListModelInterface"></a><h3>struct GListModelInterface</h3>
+<pre class="programlisting">struct GListModelInterface {
+  GTypeInterface g_iface;
+  GType     (* get_item_type)   (GListModel *list);
+  guint     (* get_n_items)     (GListModel *list);
+  gpointer  (* get_item)        (GListModel *list,
+                                 guint       position);
+};
+</pre>
+<p>The virtual function table for <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a>.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.12.3.5"></a><h4>Members</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="300px" class="struct_members_name">
+<col class="struct_members_description">
+<col width="200px" class="struct_members_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="struct_member_name"><p><a href="../gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GListModelInterface.g-iface"></a>g_iface</code></em>;</p></td>
+<td class="struct_member_description"><p>parent <a href="../gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GListModelInterface.get-item-type"></a>get_item_type</code></em> ()</p></td>
+<td class="struct_member_description"><p>the virtual function pointer for <a class="link" href="GListModel.html#g-list-model-get-item-type" title="g_list_model_get_item_type ()"><code class="function">g_list_model_get_item_type()</code></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GListModelInterface.get-n-items"></a>get_n_items</code></em> ()</p></td>
+<td class="struct_member_description"><p>the virtual function pointer for <a class="link" href="GListModel.html#g-list-model-get-n-items" title="g_list_model_get_n_items ()"><code class="function">g_list_model_get_n_items()</code></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GListModelInterface.get-item"></a>get_item</code></em> ()</p></td>
+<td class="struct_member_description"><p>the virtual function pointer for <a class="link" href="GListModel.html#g-list-model-get-item" title="g_list_model_get_item ()"><code class="function">g_list_model_get_item()</code></a></p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since 2.44</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GListModel.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GListModel-items-changed"></a><h3>The <code class="literal">“items-changed”</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+user_function (<a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> *list,
+               <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>       position,
+               <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>       removed,
+               <a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a>       added,
+               <a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)</pre>
+<p>This signal is emitted whenever items were added or removed to
+<em class="parameter"><code>list</code></em>
+. At <em class="parameter"><code>position</code></em>
+, <em class="parameter"><code>removed</code></em>
+ items were removed and <em class="parameter"><code>added</code></em>
+ items
+were added in their place.</p>
+<div class="refsect3">
+<a name="id-1.4.22.2.13.2.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>list</p></td>
+<td class="parameter_description"><p>the <a class="link" href="GListModel.html" title="GListModel"><span class="type">GListModel</span></a> that changed</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>position</p></td>
+<td class="parameter_description"><p>the position at which <em class="parameter"><code>list</code></em>
+changed</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>removed</p></td>
+<td class="parameter_description"><p>the number of items removed</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>added</p></td>
+<td class="parameter_description"><p>the number of items added</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>user_data</p></td>
+<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
+<p class="since">Since 2.44</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GListModel.see-also"></a><h2>See Also</h2>
+<p><a class="link" href="GListStore.html" title="GListStore"><span class="type">GListStore</span></a></p>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.21.1</div>
+</body>
+</html>