glib-io-channels.html

glid编写实例

</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2910054"></a><h3>
<a name="g-io-channel-read-line-string"></a>g_io_channel_read_line_string ()</h3>
<a class="indexterm" name="id2910065"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_read_line_string   (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Strings.html#GString">GString</a> *buffer,
                                             <a href="glib-Basic-Types.html#gsize">gsize</a> *terminator_pos,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Reads a line from a <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>, using a <a href="glib-Strings.html#GString"><span class="type">GString</span></a> as a buffer.</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>buffer</code></em>&#160;:</span></td>
<td> a <a href="glib-Strings.html#GString"><span class="type">GString</span></a> into which the line will be written.
         If <em class="parameter"><code>buffer</code></em> already contains data, the old data will
         be overwritten.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>terminator_pos</code></em>&#160;:</span></td>
<td> location to store position of line terminator, or <code class="literal">NULL</code>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
<td> a location to store an error of type <a href="glib-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <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="id2910254"></a><h3>
<a name="g-io-channel-read-to-end"></a>g_io_channel_read_to_end ()</h3>
<a class="indexterm" name="id2910265"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_read_to_end        (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Basic-Types.html#gchar">gchar</a> **str_return,
                                             <a href="glib-Basic-Types.html#gsize">gsize</a> *length,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Reads all the remaining data from the file.</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>str_return</code></em>&#160;:</span></td>
<td> Location to store a pointer to a string holding
             the remaining data in the <a href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>. This data should
             be freed with <a href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed. This
             data is terminated by an extra nul character, but there 
             may be other nuls in the intervening data.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td>
<td> Location to store length of the data
</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-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <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> <code class="literal">G_IO_STATUS_NORMAL</code> on success. 
This function never returns <code class="literal">G_IO_STATUS_EOF</code>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2910450"></a><h3>
<a name="g-io-channel-write-chars"></a>g_io_channel_write_chars ()</h3>
<a class="indexterm" name="id2910461"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_write_chars        (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *buf,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> count,
                                             <a href="glib-Basic-Types.html#gsize">gsize</a> *bytes_written,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Replacement for <a href="glib-IO-Channels.html#g-io-channel-write"><code class="function">g_io_channel_write()</code></a> with the new API.
</p>
<p>
On seekable channels with encodings other than <code class="literal">NULL</code> or UTF-8, generic
mixing of reading and writing is not allowed. A call to <a href="glib-IO-Channels.html#g-io-channel-write-chars"><code class="function">g_io_channel_write_chars()</code></a>
may only be made on a channel from which data has been read in the
cases described in the documentation for <a href="glib-IO-Channels.html#g-io-channel-set-encoding"><code class="function">g_io_channel_set_encoding()</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>buf</code></em>&#160;:</span></td>
<td> a buffer to write data from
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>count</code></em>&#160;:</span></td>
<td> the size of the buffer. If -1, the buffer
        is taken to be a nul-terminated string.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>bytes_written</code></em>&#160;:</span></td>
<td> The number of bytes written. This can be nonzero
                even if the return value is not <code class="literal">G_IO_STATUS_NORMAL</code>.
                If the return value is <code class="literal">G_IO_STATUS_NORMAL</code> and the
                channel is blocking, this will always be equal
                to <em class="parameter"><code>count</code></em> if <em class="parameter"><code>count</code></em> &gt;= 0.
</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-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <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="id2910708"></a><h3>
<a name="g-io-channel-write-unichar"></a>g_io_channel_write_unichar ()</h3>
<a class="indexterm" name="id2910720"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_write_unichar      (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> thechar,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
This function cannot be called on a channel with <code class="literal">NULL</code> encoding.</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>thechar</code></em>&#160;:</span></td>
<td> a character
</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-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <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> a <a href="glib-IO-Channels.html#GIOStatus"><span class="type">GIOStatus</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2910861"></a><h3>
<a name="g-io-channel-flush"></a>g_io_channel_flush ()</h3>
<a class="indexterm" name="id2910872"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_flush              (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Flushes the write buffer for the GIOChannel.</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>error</code></em>&#160;:</span></td>
<td> location to store 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: One of
  <span class="type">G_IO_CHANNEL_NORMAL</span>, <span class="type">G_IO_CHANNEL_AGAIN</span>, or
  <a href="glib-IO-Channels.html#G-IO-CHANNEL-ERROR:CAPS"><span class="type">G_IO_CHANNEL_ERROR</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2910999"></a><h3>
<a name="g-io-channel-seek-position"></a>g_io_channel_seek_position ()</h3>
<a class="indexterm" name="id2911010"></a><pre class="programlisting"><a href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>   g_io_channel_seek_position      (<a href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                             <a href="glib-Basic-Types.html#gint64">gint64</a> offset,
                                             <a href="glib-IO-Channels.html#GSeekType">GSeekType</a> type,
                                             <a href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>