glib-io-channels.html

glid编写实例

Replacement for <a href="glib-IO-Channels.html#g-io-channel-seek"><code class="function">g_io_channel_seek()</code></a> with the new API.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
<td> a <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>offset</code></em>&#160;:</span></td>
<td> The offset in bytes from the position specified by <em class="parameter"><code>type</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></td>
<td> a <a href="glib-IO-Channels.html#GSeekType"><span class="type">GSeekType</span></a>. The type <code class="literal">G_SEEK_CUR</code> is only allowed in those
                     cases where a call to <a href="glib-IO-Channels.html#g-io-channel-set-encoding"><code class="function">g_io_channel_set_encoding()</code></a>
                     is allowed. See the documentation for
                     <a href="glib-IO-Channels.html#g-io-channel-set-encoding"><code class="function">g_io_channel_set_encoding()</code></a> for details.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> A location to return an error of type <a href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the status of the operation.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2911206"></a><h3>
<a name="GSeekType"></a>enum GSeekType</h3>
<a class="indexterm" name="id2911217"></a><pre class="programlisting">typedef enum
{
  G_SEEK_CUR,
  G_SEEK_SET,
  G_SEEK_END
} GSeekType;
</pre>
<p>
An enumeration specifying the base position for a <a href="glib-IO-Channels.html#g-io-channel-seek-position"><code class="function">g_io_channel_seek_position()</code></a>
operation.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">G_SEEK_CUR</code></span></td>
<td>the current position in the file.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_SEEK_SET</code></span></td>
<td>the start of the file.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_SEEK_END</code></span></td>
<td>the end of the file.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2911293"></a><h3>
<a name="g-io-channel-shutdown"></a>g_io_channel_shutdown ()</h3>
<a class="indexterm" name="id2911304"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_shutdown           (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Basic-Types.html#gboolean">gboolean</a> flush,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **err);</pre>
<p>
Close an IO channel. Any pending data to be written will be
flushed if <em class="parameter"><code>flush</code></em> is <code class="literal">TRUE</code>. The channel will not be freed until the
last reference is dropped using <a href="glib-IO-Channels.html#g-io-channel-unref"><code class="function">g_io_channel_unref()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></td>
<td> a <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>flush</code></em>&#160;:</span></td>
<td> if <code class="literal">TRUE</code>, flush pending
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>err</code></em>&#160;:</span></td>
<td> location to store a <a href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the status of the operation.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2911455"></a><h3>
<a name="GIOStatus"></a>enum GIOStatus</h3>
<a class="indexterm" name="id2911465"></a><pre class="programlisting">typedef enum
{
  G_IO_STATUS_ERROR,
  G_IO_STATUS_NORMAL,
  G_IO_STATUS_EOF,
  G_IO_STATUS_AGAIN
} GIOStatus;
</pre>
<p>
Stati returned by most of the <a href="glib-IO-Channels.html#GIOFuncs"><span class="type">GIOFuncs</span></a> functions. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">G_IO_STATUS_ERROR</code></span></td>
<td>An error occurred.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_STATUS_NORMAL</code></span></td>
<td>Success.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_STATUS_EOF</code></span></td>
<td>End of file.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_STATUS_AGAIN</code></span></td>
<td>Resource temporarily unavailable.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2911554"></a><h3>
<a name="GIOChannelError"></a>enum GIOChannelError</h3>
<a class="indexterm" name="id2911565"></a><pre class="programlisting">typedef enum
{
  /* Derived from errno */
  G_IO_CHANNEL_ERROR_FBIG,
  G_IO_CHANNEL_ERROR_INVAL,
  G_IO_CHANNEL_ERROR_IO,
  G_IO_CHANNEL_ERROR_ISDIR,
  G_IO_CHANNEL_ERROR_NOSPC,
  G_IO_CHANNEL_ERROR_NXIO,
  G_IO_CHANNEL_ERROR_OVERFLOW,
  G_IO_CHANNEL_ERROR_PIPE,
  /* Other */
  G_IO_CHANNEL_ERROR_FAILED
} GIOChannelError;
</pre>
<p>
Error codes returned by <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a> operations.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_FBIG</code></span></td>
<td>File too large.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_INVAL</code></span></td>
<td>Invalid argument.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_IO</code></span></td>
<td>IO error.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_ISDIR</code></span></td>
<td>File is a directory.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_NOSPC</code></span></td>
<td>No space left on device.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_NXIO</code></span></td>
<td>No such device or address.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_OVERFLOW</code></span></td>
<td>Value too large for defined datatype.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_PIPE</code></span></td>
<td>Broken pipe.
</td>
</tr>
<tr>
<td>
<span class="term"><code class="literal">G_IO_CHANNEL_ERROR_FAILED</code></span></td>
<td>Some other error.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2911733"></a><h3>
<a name="G-IO-CHANNEL-ERROR:CAPS"></a>G_IO_CHANNEL_ERROR</h3>
<a class="indexterm" name="id2911745"></a><pre class="programlisting">#define G_IO_CHANNEL_ERROR g_io_channel_error_quark()
</pre>
<p>
Error domain for <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a> operations. Errors in this domain will
be from the <a href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a> enumeration. See <a href="glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for information on
error domains.