← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/glib2.0/intrepid-updates

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/GInputStream.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge, Loic Minier, Sebastian Dröge
  • Date: 2008-07-22 11:17:05 UTC
  • mfrom: (1.2.44 upstream)
  • Revision ID: james.westby@ubuntu.com-20080722111705-0ejknwv7o1dyxmjj
Tags: 2.17.4-1
[ Loic Minier ]
* List back m68k in arches where we could make the testsuite fatal,
  following the update on GNOME #481575.
* Document why testsuite is currently completely disabled (fails when
  there's no writable $HOME).

[ Sebastian Dröge ]
* New upstream development release, the new API might still change:
  + debian/rules,
    debian/libglib2.0-0.symbols:
    - Updated for the new symbols.
  + debian/patches/90_gio-nautilus-crash.patch:
    - Dropped, merged upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/html/GInputStream.html
14
14
<link rel="chapter" href="ch01.html" title="Introduction">
15
15
<link rel="chapter" href="ch02.html" title="Compiling GIO applications">
16
16
<link rel="chapter" href="ch03.html" title="Running GIO applications">
17
 
<link rel="chapter" href="gio-extension-points.html" title="Extending GIO">
 
17
<link rel="chapter" href="extending-gio.html" title="Extending GIO">
18
18
<link rel="part" href="pt02.html" title="Part II. API Reference">
19
19
<link rel="chapter" href="file_ops.html" title="File Operations">
20
20
<link rel="chapter" href="file_mon.html" title="File System Monitoring">
63
63
#include &lt;gio/gio.h&gt;
64
64
 
65
65
                    <a class="link" href="GInputStream.html#GInputStream-struct" title="GInputStream">GInputStream</a>;
66
 
<a
67
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
68
 
>gssize</a>              <a class="link" href="GInputStream.html#g-input-stream-read" title="g_input_stream_read ()">g_input_stream_read</a>                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
66
gssize              <a class="link" href="GInputStream.html#g-input-stream-read" title="g_input_stream_read ()">g_input_stream_read</a>                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
69
67
                                                         void *buffer,
70
 
                                                         <a
71
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
72
 
>gsize</a> count,
 
68
                                                         gsize count,
73
69
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
74
70
                                                         <a
75
71
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
78
74
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
79
75
>gboolean</a>            <a class="link" href="GInputStream.html#g-input-stream-read-all" title="g_input_stream_read_all ()">g_input_stream_read_all</a>             (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
80
76
                                                         void *buffer,
81
 
                                                         <a
82
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
83
 
>gsize</a> count,
84
 
                                                         <a
85
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
86
 
>gsize</a> *bytes_read,
 
77
                                                         gsize count,
 
78
                                                         gsize *bytes_read,
87
79
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
88
80
                                                         <a
89
81
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
90
82
>GError</a> **error);
91
 
<a
92
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
93
 
>gssize</a>              <a class="link" href="GInputStream.html#g-input-stream-skip" title="g_input_stream_skip ()">g_input_stream_skip</a>                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
94
 
                                                         <a
95
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
96
 
>gsize</a> count,
 
83
gssize              <a class="link" href="GInputStream.html#g-input-stream-skip" title="g_input_stream_skip ()">g_input_stream_skip</a>                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
84
                                                         gsize count,
97
85
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
98
86
                                                         <a
99
87
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
107
95
>GError</a> **error);
108
96
void                <a class="link" href="GInputStream.html#g-input-stream-read-async" title="g_input_stream_read_async ()">g_input_stream_read_async</a>           (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
109
97
                                                         void *buffer,
110
 
                                                         <a
111
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
112
 
>gsize</a> count,
 
98
                                                         gsize count,
113
99
                                                         int io_priority,
114
100
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
115
101
                                                         <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
116
102
                                                         <a
117
103
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
118
104
>gpointer</a> user_data);
119
 
<a
120
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
121
 
>gssize</a>              <a class="link" href="GInputStream.html#g-input-stream-read-finish" title="g_input_stream_read_finish ()">g_input_stream_read_finish</a>          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
105
gssize              <a class="link" href="GInputStream.html#g-input-stream-read-finish" title="g_input_stream_read_finish ()">g_input_stream_read_finish</a>          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
122
106
                                                         <a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
123
107
                                                         <a
124
108
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
125
109
>GError</a> **error);
126
110
void                <a class="link" href="GInputStream.html#g-input-stream-skip-async" title="g_input_stream_skip_async ()">g_input_stream_skip_async</a>           (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
127
 
                                                         <a
128
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
129
 
>gsize</a> count,
 
111
                                                         gsize count,
130
112
                                                         int io_priority,
131
113
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
132
114
                                                         <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
133
115
                                                         <a
134
116
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
135
117
>gpointer</a> user_data);
136
 
<a
137
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
138
 
>gssize</a>              <a class="link" href="GInputStream.html#g-input-stream-skip-finish" title="g_input_stream_skip_finish ()">g_input_stream_skip_finish</a>          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
118
gssize              <a class="link" href="GInputStream.html#g-input-stream-skip-finish" title="g_input_stream_skip_finish ()">g_input_stream_skip_finish</a>          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
139
119
                                                         <a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
140
120
                                                         <a
141
121
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
204
184
<hr>
205
185
<div class="refsect2" lang="en">
206
186
<a name="g-input-stream-read"></a><h3>g_input_stream_read ()</h3>
207
 
<pre class="programlisting"><a
208
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
209
 
>gssize</a>              g_input_stream_read                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
187
<pre class="programlisting">gssize              g_input_stream_read                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
210
188
                                                         void *buffer,
211
 
                                                         <a
212
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
213
 
>gsize</a> count,
 
189
                                                         gsize count,
214
190
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
215
191
                                                         <a
216
192
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
221
197
</p>
222
198
<p>
223
199
If count is zero returns zero and does nothing. A value of <em class="parameter"><code>count</code></em>
224
 
larger than <a
225
 
href="/usr/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html#G-MAXSSIZE:CAPS"
226
 
><code class="literal">G_MAXSSIZE</code></a> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
 
200
larger than <code class="literal">G_MAXSSIZE</code> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
227
201
</p>
228
202
<p>
229
203
On success, the number of bytes read into the buffer is returned.
290
264
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
291
265
>gboolean</a>            g_input_stream_read_all             (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
292
266
                                                         void *buffer,
293
 
                                                         <a
294
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
295
 
>gsize</a> count,
296
 
                                                         <a
297
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
298
 
>gsize</a> *bytes_read,
 
267
                                                         gsize count,
 
268
                                                         gsize *bytes_read,
299
269
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
300
270
                                                         <a
301
271
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
376
346
<hr>
377
347
<div class="refsect2" lang="en">
378
348
<a name="g-input-stream-skip"></a><h3>g_input_stream_skip ()</h3>
379
 
<pre class="programlisting"><a
380
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
381
 
>gssize</a>              g_input_stream_skip                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
382
 
                                                         <a
383
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
384
 
>gsize</a> count,
 
349
<pre class="programlisting">gssize              g_input_stream_skip                 (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
350
                                                         gsize count,
385
351
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
386
352
                                                         <a
387
353
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
525
491
<a name="g-input-stream-read-async"></a><h3>g_input_stream_read_async ()</h3>
526
492
<pre class="programlisting">void                g_input_stream_read_async           (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
527
493
                                                         void *buffer,
528
 
                                                         <a
529
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
530
 
>gsize</a> count,
 
494
                                                         gsize count,
531
495
                                                         int io_priority,
532
496
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
533
497
                                                         <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
545
509
result in <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING:CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a> errors. 
546
510
</p>
547
511
<p>
548
 
A value of <em class="parameter"><code>count</code></em> larger than <a
549
 
href="/usr/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html#G-MAXSSIZE:CAPS"
550
 
><code class="literal">G_MAXSSIZE</code></a> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
 
512
A value of <em class="parameter"><code>count</code></em> larger than <code class="literal">G_MAXSSIZE</code> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
551
513
</p>
552
514
<p>
553
515
On success, the number of bytes read into the buffer will be passed to the
617
579
<hr>
618
580
<div class="refsect2" lang="en">
619
581
<a name="g-input-stream-read-finish"></a><h3>g_input_stream_read_finish ()</h3>
620
 
<pre class="programlisting"><a
621
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
622
 
>gssize</a>              g_input_stream_read_finish          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
582
<pre class="programlisting">gssize              g_input_stream_read_finish          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
623
583
                                                         <a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
624
584
                                                         <a
625
585
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
664
624
<div class="refsect2" lang="en">
665
625
<a name="g-input-stream-skip-async"></a><h3>g_input_stream_skip_async ()</h3>
666
626
<pre class="programlisting">void                g_input_stream_skip_async           (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
667
 
                                                         <a
668
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
669
 
>gsize</a> count,
 
627
                                                         gsize count,
670
628
                                                         int io_priority,
671
629
                                                         <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable,
672
630
                                                         <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback,
684
642
result in <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING:CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a> errors. 
685
643
</p>
686
644
<p>
687
 
A value of <em class="parameter"><code>count</code></em> larger than <a
688
 
href="/usr/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html#G-MAXSSIZE:CAPS"
689
 
><code class="literal">G_MAXSSIZE</code></a> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
 
645
A value of <em class="parameter"><code>count</code></em> larger than <code class="literal">G_MAXSSIZE</code> will cause a <a class="link" href="gio-GIOError.html#G-IO-ERROR-INVALID-ARGUMENT:CAPS"><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></a> error.
690
646
</p>
691
647
<p>
692
648
On success, the number of bytes skipped will be passed to the
751
707
<hr>
752
708
<div class="refsect2" lang="en">
753
709
<a name="g-input-stream-skip-finish"></a><h3>g_input_stream_skip_finish ()</h3>
754
 
<pre class="programlisting"><a
755
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"
756
 
>gssize</a>              g_input_stream_skip_finish          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
 
710
<pre class="programlisting">gssize              g_input_stream_skip_finish          (<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> *stream,
757
711
                                                         <a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result,
758
712
                                                         <a
759
713
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"