glib-io-channels.html

最新gtk中文资料集

</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a class="link" 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="id2930904"></a><h3>
<a name="g-io-channel-read-line"></a>g_io_channel_read_line ()</h3>
<a class="indexterm" name="id2930917"></a><pre class="programlisting"><a class="link" href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>           g_io_channel_read_line              (<a class="link" href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_return,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *length,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *terminator_pos,
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Reads a line, including the terminating character(s),
from a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a> into a newly-allocated string.
<em class="parameter"><code>str_return</code></em> will contain allocated memory if the return
is <a class="link" href="glib-IO-Channels.html#G-IO-STATUS-NORMAL:CAPS"><code class="literal">G_IO_STATUS_NORMAL</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str_return</code></em>&#160;:</span></p></td>
<td> The line read from the <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>, including the
             line terminator. This data should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
             when no longer needed. This is a nul-terminated string. 
             If a <em class="parameter"><code>length</code></em> of zero is returned, this will be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> location to store length of the read data, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>terminator_pos</code></em>&#160;:</span></p></td>
<td> location to store position of line terminator, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> A location to return an error of type <a class="link" href="glib-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <a class="link" href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the status of the operation.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2931176"></a><h3>
<a name="g-io-channel-read-line-string"></a>g_io_channel_read_line_string ()</h3>
<a class="indexterm" name="id2931190"></a><pre class="programlisting"><a class="link" href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>           g_io_channel_read_line_string       (<a class="link" href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                                         <a class="link" href="glib-Strings.html#GString">GString</a> *buffer,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *terminator_pos,
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Reads a line from a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>, using a <a class="link" 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><p><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></p></td>
<td> a <a class="link" 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><p><span class="term"><em class="parameter"><code>terminator_pos</code></em>&#160;:</span></p></td>
<td> location to store position of line terminator, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> a location to store an error of type <a class="link" href="glib-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <a class="link" href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the status of the operation.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2931383"></a><h3>
<a name="g-io-channel-read-to-end"></a>g_io_channel_read_to_end ()</h3>
<a class="indexterm" name="id2931396"></a><pre class="programlisting"><a class="link" href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>           g_io_channel_read_to_end            (<a class="link" href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_return,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *length,
                                                         <a class="link" 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><p><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str_return</code></em>&#160;:</span></p></td>
<td> Location to store a pointer to a string holding
             the remaining data in the <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>. This data should
             be freed with <a class="link" 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><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> location to store length of the data
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
<td> location to return an error of type <a class="link" href="glib-Character-Set-Conversion.html#GConvertError"><span class="type">GConvertError</span></a>
        or <a class="link" href="glib-IO-Channels.html#GIOChannelError"><span class="type">GIOChannelError</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a class="link" href="glib-IO-Channels.html#G-IO-STATUS-NORMAL:CAPS"><code class="literal">G_IO_STATUS_NORMAL</code></a> on success. 
    This function never returns <a class="link" href="glib-IO-Channels.html#G-IO-STATUS-EOF:CAPS"><code class="literal">G_IO_STATUS_EOF</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2931593"></a><h3>
<a name="g-io-channel-write-chars"></a>g_io_channel_write_chars ()</h3>
<a class="indexterm" name="id2931606"></a><pre class="programlisting"><a class="link" href="glib-IO-Channels.html#GIOStatus">GIOStatus</a>           g_io_channel_write_chars            (<a class="link" href="glib-IO-Channels.html#GIOChannel">GIOChannel</a> *channel,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *buf,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> count,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *bytes_written,
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
<p>
Replacement for <a class="link" 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 <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or UTF-8, generic
mixing of reading and writing is not allowed. A call to <a class="link" 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 class="link" 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><p><span class="term"><em class="parameter"><code>channel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-IO-Channels.html#GIOChannel"><span class="type">GIOChannel</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buf</code></em>&#160;:</span></p></td>
<td> a buffer to write data from
</td>