1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
4 * Copyright (C) 2007 Jürg Billeter
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General
17 * Public License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
19 * Boston, MA 02111-1307, USA.
21 * Author: Christian Kellner <gicmo@gnome.org>
25 #include "gbufferedinputstream.h"
26 #include "ginputstream.h"
27 #include "gcancellable.h"
28 #include "gasyncresult.h"
30 #include "gseekable.h"
37 * SECTION:gbufferedinputstream
38 * @short_description: Buffered Input Stream
40 * @see_also: #GFilterInputStream, #GInputStream
42 * Buffered input stream implements #GFilterInputStream and provides
45 * By default, #GBufferedInputStream's buffer size is set at 4 kilobytes.
47 * To create a buffered input stream, use g_buffered_input_stream_new(),
48 * or g_buffered_input_stream_new_sized() to specify the buffer's size at
51 * To get the size of a buffer within a buffered input stream, use
52 * g_buffered_input_stream_get_buffer_size(). To change the size of a
53 * buffered input stream's buffer, use
54 * g_buffered_input_stream_set_buffer_size(). Note that the buffer's size
55 * cannot be reduced below the size of the data within the buffer.
59 #define DEFAULT_BUFFER_SIZE 4096
61 struct _GBufferedInputStreamPrivate
{
66 GAsyncReadyCallback outstanding_callback
;
74 static void g_buffered_input_stream_set_property (GObject
*object
,
79 static void g_buffered_input_stream_get_property (GObject
*object
,
83 static void g_buffered_input_stream_finalize (GObject
*object
);
86 static gssize
g_buffered_input_stream_skip (GInputStream
*stream
,
88 GCancellable
*cancellable
,
90 static void g_buffered_input_stream_skip_async (GInputStream
*stream
,
93 GCancellable
*cancellable
,
94 GAsyncReadyCallback callback
,
96 static gssize
g_buffered_input_stream_skip_finish (GInputStream
*stream
,
99 static gssize
g_buffered_input_stream_read (GInputStream
*stream
,
102 GCancellable
*cancellable
,
104 static gssize
g_buffered_input_stream_real_fill (GBufferedInputStream
*stream
,
106 GCancellable
*cancellable
,
108 static void g_buffered_input_stream_real_fill_async (GBufferedInputStream
*stream
,
111 GCancellable
*cancellable
,
112 GAsyncReadyCallback callback
,
114 static gssize
g_buffered_input_stream_real_fill_finish (GBufferedInputStream
*stream
,
115 GAsyncResult
*result
,
118 static void g_buffered_input_stream_seekable_iface_init (GSeekableIface
*iface
);
119 static goffset
g_buffered_input_stream_tell (GSeekable
*seekable
);
120 static gboolean
g_buffered_input_stream_can_seek (GSeekable
*seekable
);
121 static gboolean
g_buffered_input_stream_seek (GSeekable
*seekable
,
124 GCancellable
*cancellable
,
126 static gboolean
g_buffered_input_stream_can_truncate (GSeekable
*seekable
);
127 static gboolean
g_buffered_input_stream_truncate (GSeekable
*seekable
,
129 GCancellable
*cancellable
,
132 static void g_buffered_input_stream_finalize (GObject
*object
);
134 static void compact_buffer (GBufferedInputStream
*stream
);
136 G_DEFINE_TYPE_WITH_CODE (GBufferedInputStream
,
137 g_buffered_input_stream
,
138 G_TYPE_FILTER_INPUT_STREAM
,
139 G_IMPLEMENT_INTERFACE (G_TYPE_SEEKABLE
,
140 g_buffered_input_stream_seekable_iface_init
))
143 g_buffered_input_stream_class_init (GBufferedInputStreamClass
*klass
)
145 GObjectClass
*object_class
;
146 GInputStreamClass
*istream_class
;
147 GBufferedInputStreamClass
*bstream_class
;
149 g_type_class_add_private (klass
, sizeof (GBufferedInputStreamPrivate
));
151 object_class
= G_OBJECT_CLASS (klass
);
152 object_class
->get_property
= g_buffered_input_stream_get_property
;
153 object_class
->set_property
= g_buffered_input_stream_set_property
;
154 object_class
->finalize
= g_buffered_input_stream_finalize
;
156 istream_class
= G_INPUT_STREAM_CLASS (klass
);
157 istream_class
->skip
= g_buffered_input_stream_skip
;
158 istream_class
->skip_async
= g_buffered_input_stream_skip_async
;
159 istream_class
->skip_finish
= g_buffered_input_stream_skip_finish
;
160 istream_class
->read_fn
= g_buffered_input_stream_read
;
162 bstream_class
= G_BUFFERED_INPUT_STREAM_CLASS (klass
);
163 bstream_class
->fill
= g_buffered_input_stream_real_fill
;
164 bstream_class
->fill_async
= g_buffered_input_stream_real_fill_async
;
165 bstream_class
->fill_finish
= g_buffered_input_stream_real_fill_finish
;
167 g_object_class_install_property (object_class
,
169 g_param_spec_uint ("buffer-size",
171 P_("The size of the backend buffer"),
175 G_PARAM_READWRITE
| G_PARAM_CONSTRUCT
|
176 G_PARAM_STATIC_NAME
|G_PARAM_STATIC_NICK
|G_PARAM_STATIC_BLURB
));
182 * g_buffered_input_stream_get_buffer_size:
183 * @stream: a #GBufferedInputStream
185 * Gets the size of the input buffer.
187 * Returns: the current buffer size.
190 g_buffered_input_stream_get_buffer_size (GBufferedInputStream
*stream
)
192 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), 0);
194 return stream
->priv
->len
;
198 * g_buffered_input_stream_set_buffer_size:
199 * @stream: a #GBufferedInputStream
202 * Sets the size of the internal buffer of @stream to @size, or to the
203 * size of the contents of the buffer. The buffer can never be resized
204 * smaller than its current contents.
207 g_buffered_input_stream_set_buffer_size (GBufferedInputStream
*stream
,
210 GBufferedInputStreamPrivate
*priv
;
214 g_return_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
));
218 if (priv
->len
== size
)
223 in_buffer
= priv
->end
- priv
->pos
;
225 /* Never resize smaller than current buffer contents */
226 size
= MAX (size
, in_buffer
);
228 buffer
= g_malloc (size
);
229 memcpy (buffer
, priv
->buffer
+ priv
->pos
, in_buffer
);
232 priv
->end
= in_buffer
;
233 g_free (priv
->buffer
);
234 priv
->buffer
= buffer
;
241 priv
->buffer
= g_malloc (size
);
244 g_object_notify (G_OBJECT (stream
), "buffer-size");
248 g_buffered_input_stream_set_property (GObject
*object
,
253 GBufferedInputStream
*bstream
;
255 bstream
= G_BUFFERED_INPUT_STREAM (object
);
260 g_buffered_input_stream_set_buffer_size (bstream
, g_value_get_uint (value
));
264 G_OBJECT_WARN_INVALID_PROPERTY_ID (object
, prop_id
, pspec
);
270 g_buffered_input_stream_get_property (GObject
*object
,
275 GBufferedInputStreamPrivate
*priv
;
276 GBufferedInputStream
*bstream
;
278 bstream
= G_BUFFERED_INPUT_STREAM (object
);
279 priv
= bstream
->priv
;
284 g_value_set_uint (value
, priv
->len
);
288 G_OBJECT_WARN_INVALID_PROPERTY_ID (object
, prop_id
, pspec
);
294 g_buffered_input_stream_finalize (GObject
*object
)
296 GBufferedInputStreamPrivate
*priv
;
297 GBufferedInputStream
*stream
;
299 stream
= G_BUFFERED_INPUT_STREAM (object
);
302 g_free (priv
->buffer
);
304 G_OBJECT_CLASS (g_buffered_input_stream_parent_class
)->finalize (object
);
308 g_buffered_input_stream_seekable_iface_init (GSeekableIface
*iface
)
310 iface
->tell
= g_buffered_input_stream_tell
;
311 iface
->can_seek
= g_buffered_input_stream_can_seek
;
312 iface
->seek
= g_buffered_input_stream_seek
;
313 iface
->can_truncate
= g_buffered_input_stream_can_truncate
;
314 iface
->truncate_fn
= g_buffered_input_stream_truncate
;
318 g_buffered_input_stream_init (GBufferedInputStream
*stream
)
320 stream
->priv
= G_TYPE_INSTANCE_GET_PRIVATE (stream
,
321 G_TYPE_BUFFERED_INPUT_STREAM
,
322 GBufferedInputStreamPrivate
);
327 * g_buffered_input_stream_new:
328 * @base_stream: a #GInputStream
330 * Creates a new #GInputStream from the given @base_stream, with
331 * a buffer set to the default size (4 kilobytes).
333 * Returns: a #GInputStream for the given @base_stream.
336 g_buffered_input_stream_new (GInputStream
*base_stream
)
338 GInputStream
*stream
;
340 g_return_val_if_fail (G_IS_INPUT_STREAM (base_stream
), NULL
);
342 stream
= g_object_new (G_TYPE_BUFFERED_INPUT_STREAM
,
343 "base-stream", base_stream
,
350 * g_buffered_input_stream_new_sized:
351 * @base_stream: a #GInputStream
354 * Creates a new #GBufferedInputStream from the given @base_stream,
355 * with a buffer set to @size.
357 * Returns: a #GInputStream.
360 g_buffered_input_stream_new_sized (GInputStream
*base_stream
,
363 GInputStream
*stream
;
365 g_return_val_if_fail (G_IS_INPUT_STREAM (base_stream
), NULL
);
367 stream
= g_object_new (G_TYPE_BUFFERED_INPUT_STREAM
,
368 "base-stream", base_stream
,
369 "buffer-size", (guint
)size
,
376 * g_buffered_input_stream_fill:
377 * @stream: a #GBufferedInputStream
378 * @count: the number of bytes that will be read from the stream
379 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
380 * @error: location to store the error occurring, or %NULL to ignore
382 * Tries to read @count bytes from the stream into the buffer.
383 * Will block during this read.
385 * If @count is zero, returns zero and does nothing. A value of @count
386 * larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
388 * On success, the number of bytes read into the buffer is returned.
389 * It is not an error if this is not the same as the requested size, as it
390 * can happen e.g. near the end of a file. Zero is returned on end of file
391 * (or if @count is zero), but never otherwise.
393 * If @count is -1 then the attempted read size is equal to the number of
394 * bytes that are required to fill the buffer.
396 * If @cancellable is not %NULL, then the operation can be cancelled by
397 * triggering the cancellable object from another thread. If the operation
398 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
399 * operation was partially finished when the operation was cancelled the
400 * partial result will be returned, without an error.
402 * On error -1 is returned and @error is set accordingly.
404 * For the asynchronous, non-blocking, version of this function, see
405 * g_buffered_input_stream_fill_async().
407 * Returns: the number of bytes read into @stream's buffer, up to @count,
411 g_buffered_input_stream_fill (GBufferedInputStream
*stream
,
413 GCancellable
*cancellable
,
416 GBufferedInputStreamClass
*class;
417 GInputStream
*input_stream
;
420 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), -1);
422 input_stream
= G_INPUT_STREAM (stream
);
426 g_set_error (error
, G_IO_ERROR
, G_IO_ERROR_INVALID_ARGUMENT
,
427 _("Too large count value passed to %s"), G_STRFUNC
);
431 if (!g_input_stream_set_pending (input_stream
, error
))
435 g_cancellable_push_current (cancellable
);
437 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
438 res
= class->fill (stream
, count
, cancellable
, error
);
441 g_cancellable_pop_current (cancellable
);
443 g_input_stream_clear_pending (input_stream
);
449 async_fill_callback_wrapper (GObject
*source_object
,
453 GBufferedInputStream
*stream
= G_BUFFERED_INPUT_STREAM (source_object
);
455 g_input_stream_clear_pending (G_INPUT_STREAM (stream
));
456 (*stream
->priv
->outstanding_callback
) (source_object
, res
, user_data
);
457 g_object_unref (stream
);
461 * g_buffered_input_stream_fill_async:
462 * @stream: a #GBufferedInputStream
463 * @count: the number of bytes that will be read from the stream
464 * @io_priority: the <link linkend="io-priority">I/O priority</link>
466 * @cancellable: (allow-none): optional #GCancellable object
467 * @callback: (scope async): a #GAsyncReadyCallback
468 * @user_data: (closure): a #gpointer
470 * Reads data into @stream's buffer asynchronously, up to @count size.
471 * @io_priority can be used to prioritize reads. For the synchronous
472 * version of this function, see g_buffered_input_stream_fill().
474 * If @count is -1 then the attempted read size is equal to the number
475 * of bytes that are required to fill the buffer.
478 g_buffered_input_stream_fill_async (GBufferedInputStream
*stream
,
481 GCancellable
*cancellable
,
482 GAsyncReadyCallback callback
,
485 GBufferedInputStreamClass
*class;
486 GError
*error
= NULL
;
488 g_return_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
));
494 task
= g_task_new (stream
, cancellable
, callback
, user_data
);
495 g_task_set_source_tag (task
, g_buffered_input_stream_fill_async
);
496 g_task_return_int (task
, 0);
497 g_object_unref (task
);
503 g_task_report_new_error (stream
, callback
, user_data
,
504 g_buffered_input_stream_fill_async
,
505 G_IO_ERROR
, G_IO_ERROR_INVALID_ARGUMENT
,
506 _("Too large count value passed to %s"),
511 if (!g_input_stream_set_pending (G_INPUT_STREAM (stream
), &error
))
513 g_task_report_error (stream
, callback
, user_data
,
514 g_buffered_input_stream_fill_async
,
519 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
521 stream
->priv
->outstanding_callback
= callback
;
522 g_object_ref (stream
);
523 class->fill_async (stream
, count
, io_priority
, cancellable
,
524 async_fill_callback_wrapper
, user_data
);
528 * g_buffered_input_stream_fill_finish:
529 * @stream: a #GBufferedInputStream
530 * @result: a #GAsyncResult
533 * Finishes an asynchronous read.
535 * Returns: a #gssize of the read stream, or %-1 on an error.
538 g_buffered_input_stream_fill_finish (GBufferedInputStream
*stream
,
539 GAsyncResult
*result
,
542 GBufferedInputStreamClass
*class;
544 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), -1);
545 g_return_val_if_fail (G_IS_ASYNC_RESULT (result
), -1);
547 if (g_async_result_legacy_propagate_error (result
, error
))
549 else if (g_async_result_is_tagged (result
, g_buffered_input_stream_fill_async
))
550 return g_task_propagate_int (G_TASK (result
), error
);
552 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
553 return class->fill_finish (stream
, result
, error
);
557 * g_buffered_input_stream_get_available:
558 * @stream: #GBufferedInputStream
560 * Gets the size of the available data within the stream.
562 * Returns: size of the available stream.
565 g_buffered_input_stream_get_available (GBufferedInputStream
*stream
)
567 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), -1);
569 return stream
->priv
->end
- stream
->priv
->pos
;
573 * g_buffered_input_stream_peek:
574 * @stream: a #GBufferedInputStream
575 * @buffer: (array length=count) (element-type guint8): a pointer to
576 * an allocated chunk of memory
580 * Peeks in the buffer, copying data of size @count into @buffer,
581 * offset @offset bytes.
583 * Returns: a #gsize of the number of bytes peeked, or -1 on error.
586 g_buffered_input_stream_peek (GBufferedInputStream
*stream
,
594 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), -1);
595 g_return_val_if_fail (buffer
!= NULL
, -1);
597 available
= g_buffered_input_stream_get_available (stream
);
599 if (offset
> available
)
602 end
= MIN (offset
+ count
, available
);
603 count
= end
- offset
;
605 memcpy (buffer
, stream
->priv
->buffer
+ stream
->priv
->pos
+ offset
, count
);
610 * g_buffered_input_stream_peek_buffer:
611 * @stream: a #GBufferedInputStream
612 * @count: (out): a #gsize to get the number of bytes available in the buffer
614 * Returns the buffer with the currently available bytes. The returned
615 * buffer must not be modified and will become invalid when reading from
616 * the stream or filling the buffer.
618 * Returns: (array length=count) (element-type guint8) (transfer none):
622 g_buffered_input_stream_peek_buffer (GBufferedInputStream
*stream
,
625 GBufferedInputStreamPrivate
*priv
;
627 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), NULL
);
632 *count
= priv
->end
- priv
->pos
;
634 return priv
->buffer
+ priv
->pos
;
638 compact_buffer (GBufferedInputStream
*stream
)
640 GBufferedInputStreamPrivate
*priv
;
645 current_size
= priv
->end
- priv
->pos
;
647 g_memmove (priv
->buffer
, priv
->buffer
+ priv
->pos
, current_size
);
650 priv
->end
= current_size
;
654 g_buffered_input_stream_real_fill (GBufferedInputStream
*stream
,
656 GCancellable
*cancellable
,
659 GBufferedInputStreamPrivate
*priv
;
660 GInputStream
*base_stream
;
669 in_buffer
= priv
->end
- priv
->pos
;
671 /* Never fill more than can fit in the buffer */
672 count
= MIN (count
, priv
->len
- in_buffer
);
674 /* If requested length does not fit at end, compact */
675 if (priv
->len
- priv
->end
< count
)
676 compact_buffer (stream
);
678 base_stream
= G_FILTER_INPUT_STREAM (stream
)->base_stream
;
679 nread
= g_input_stream_read (base_stream
,
680 priv
->buffer
+ priv
->end
,
692 g_buffered_input_stream_skip (GInputStream
*stream
,
694 GCancellable
*cancellable
,
697 GBufferedInputStream
*bstream
;
698 GBufferedInputStreamPrivate
*priv
;
699 GBufferedInputStreamClass
*class;
700 GInputStream
*base_stream
;
701 gsize available
, bytes_skipped
;
704 bstream
= G_BUFFERED_INPUT_STREAM (stream
);
705 priv
= bstream
->priv
;
707 available
= priv
->end
- priv
->pos
;
709 if (count
<= available
)
715 /* Full request not available, skip all currently available and
716 * request refill for more
721 bytes_skipped
= available
;
724 if (bytes_skipped
> 0)
725 error
= NULL
; /* Ignore further errors if we already read some data */
727 if (count
> priv
->len
)
729 /* Large request, shortcut buffer */
731 base_stream
= G_FILTER_INPUT_STREAM (stream
)->base_stream
;
733 nread
= g_input_stream_skip (base_stream
,
738 if (nread
< 0 && bytes_skipped
== 0)
742 bytes_skipped
+= nread
;
744 return bytes_skipped
;
747 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
748 nread
= class->fill (bstream
, priv
->len
, cancellable
, error
);
752 if (bytes_skipped
== 0)
755 return bytes_skipped
;
758 available
= priv
->end
- priv
->pos
;
759 count
= MIN (count
, available
);
761 bytes_skipped
+= count
;
764 return bytes_skipped
;
768 g_buffered_input_stream_read (GInputStream
*stream
,
771 GCancellable
*cancellable
,
774 GBufferedInputStream
*bstream
;
775 GBufferedInputStreamPrivate
*priv
;
776 GBufferedInputStreamClass
*class;
777 GInputStream
*base_stream
;
778 gsize available
, bytes_read
;
781 bstream
= G_BUFFERED_INPUT_STREAM (stream
);
782 priv
= bstream
->priv
;
784 available
= priv
->end
- priv
->pos
;
786 if (count
<= available
)
788 memcpy (buffer
, priv
->buffer
+ priv
->pos
, count
);
793 /* Full request not available, read all currently available and
794 * request refill for more
797 memcpy (buffer
, priv
->buffer
+ priv
->pos
, available
);
800 bytes_read
= available
;
804 error
= NULL
; /* Ignore further errors if we already read some data */
806 if (count
> priv
->len
)
808 /* Large request, shortcut buffer */
810 base_stream
= G_FILTER_INPUT_STREAM (stream
)->base_stream
;
812 nread
= g_input_stream_read (base_stream
,
813 (char *)buffer
+ bytes_read
,
818 if (nread
< 0 && bytes_read
== 0)
827 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
828 nread
= class->fill (bstream
, priv
->len
, cancellable
, error
);
837 available
= priv
->end
- priv
->pos
;
838 count
= MIN (count
, available
);
840 memcpy ((char *)buffer
+ bytes_read
, (char *)priv
->buffer
+ priv
->pos
, count
);
848 g_buffered_input_stream_tell (GSeekable
*seekable
)
850 GBufferedInputStream
*bstream
;
851 GBufferedInputStreamPrivate
*priv
;
852 GInputStream
*base_stream
;
853 GSeekable
*base_stream_seekable
;
857 bstream
= G_BUFFERED_INPUT_STREAM (seekable
);
858 priv
= bstream
->priv
;
860 base_stream
= G_FILTER_INPUT_STREAM (seekable
)->base_stream
;
861 if (!G_IS_SEEKABLE (base_stream
))
863 base_stream_seekable
= G_SEEKABLE (base_stream
);
865 available
= priv
->end
- priv
->pos
;
866 base_offset
= g_seekable_tell (base_stream_seekable
);
868 return base_offset
- available
;
872 g_buffered_input_stream_can_seek (GSeekable
*seekable
)
874 GInputStream
*base_stream
;
876 base_stream
= G_FILTER_INPUT_STREAM (seekable
)->base_stream
;
877 return G_IS_SEEKABLE (base_stream
) && g_seekable_can_seek (G_SEEKABLE (base_stream
));
881 g_buffered_input_stream_seek (GSeekable
*seekable
,
884 GCancellable
*cancellable
,
887 GBufferedInputStream
*bstream
;
888 GBufferedInputStreamPrivate
*priv
;
889 GInputStream
*base_stream
;
890 GSeekable
*base_stream_seekable
;
892 bstream
= G_BUFFERED_INPUT_STREAM (seekable
);
893 priv
= bstream
->priv
;
895 base_stream
= G_FILTER_INPUT_STREAM (seekable
)->base_stream
;
896 if (!G_IS_SEEKABLE (base_stream
))
898 g_set_error_literal (error
, G_IO_ERROR
, G_IO_ERROR_NOT_SUPPORTED
,
899 _("Seek not supported on base stream"));
903 base_stream_seekable
= G_SEEKABLE (base_stream
);
905 if (type
== G_SEEK_CUR
)
907 if (offset
<= priv
->end
- priv
->pos
&& offset
>= -priv
->pos
)
914 offset
-= priv
->end
- priv
->pos
;
918 if (g_seekable_seek (base_stream_seekable
, offset
, type
, cancellable
, error
))
931 g_buffered_input_stream_can_truncate (GSeekable
*seekable
)
937 g_buffered_input_stream_truncate (GSeekable
*seekable
,
939 GCancellable
*cancellable
,
942 g_set_error_literal (error
,
944 G_IO_ERROR_NOT_SUPPORTED
,
945 _("Cannot truncate GBufferedInputStream"));
950 * g_buffered_input_stream_read_byte:
951 * @stream: a #GBufferedInputStream
952 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
953 * @error: location to store the error occurring, or %NULL to ignore
955 * Tries to read a single byte from the stream or the buffer. Will block
958 * On success, the byte read from the stream is returned. On end of stream
959 * -1 is returned but it's not an exceptional error and @error is not set.
961 * If @cancellable is not %NULL, then the operation can be cancelled by
962 * triggering the cancellable object from another thread. If the operation
963 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
964 * operation was partially finished when the operation was cancelled the
965 * partial result will be returned, without an error.
967 * On error -1 is returned and @error is set accordingly.
969 * Returns: the byte read from the @stream, or -1 on end of stream or error.
972 g_buffered_input_stream_read_byte (GBufferedInputStream
*stream
,
973 GCancellable
*cancellable
,
976 GBufferedInputStreamPrivate
*priv
;
977 GBufferedInputStreamClass
*class;
978 GInputStream
*input_stream
;
982 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream
), -1);
985 input_stream
= G_INPUT_STREAM (stream
);
987 if (g_input_stream_is_closed (input_stream
))
989 g_set_error_literal (error
, G_IO_ERROR
, G_IO_ERROR_CLOSED
,
990 _("Stream is already closed"));
994 if (!g_input_stream_set_pending (input_stream
, error
))
997 available
= priv
->end
- priv
->pos
;
1001 g_input_stream_clear_pending (input_stream
);
1002 return priv
->buffer
[priv
->pos
++];
1005 /* Byte not available, request refill for more */
1008 g_cancellable_push_current (cancellable
);
1013 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
1014 nread
= class->fill (stream
, priv
->len
, cancellable
, error
);
1017 g_cancellable_pop_current (cancellable
);
1019 g_input_stream_clear_pending (input_stream
);
1022 return -1; /* error or end of stream */
1024 return priv
->buffer
[priv
->pos
++];
1027 /* ************************** */
1028 /* Async stuff implementation */
1029 /* ************************** */
1032 fill_async_callback (GObject
*source_object
,
1033 GAsyncResult
*result
,
1038 GTask
*task
= user_data
;
1041 res
= g_input_stream_read_finish (G_INPUT_STREAM (source_object
),
1044 g_task_return_error (task
, error
);
1047 GBufferedInputStream
*stream
;
1048 GBufferedInputStreamPrivate
*priv
;
1050 stream
= g_task_get_source_object (task
);
1051 priv
= G_BUFFERED_INPUT_STREAM (stream
)->priv
;
1053 g_assert_cmpint (priv
->end
+ res
, <=, priv
->len
);
1056 g_task_return_int (task
, res
);
1059 g_object_unref (task
);
1063 g_buffered_input_stream_real_fill_async (GBufferedInputStream
*stream
,
1066 GCancellable
*cancellable
,
1067 GAsyncReadyCallback callback
,
1070 GBufferedInputStreamPrivate
*priv
;
1071 GInputStream
*base_stream
;
1075 priv
= stream
->priv
;
1080 in_buffer
= priv
->end
- priv
->pos
;
1082 /* Never fill more than can fit in the buffer */
1083 count
= MIN (count
, priv
->len
- in_buffer
);
1085 /* If requested length does not fit at end, compact */
1086 if (priv
->len
- priv
->end
< count
)
1087 compact_buffer (stream
);
1089 task
= g_task_new (stream
, cancellable
, callback
, user_data
);
1091 base_stream
= G_FILTER_INPUT_STREAM (stream
)->base_stream
;
1092 g_input_stream_read_async (base_stream
,
1093 priv
->buffer
+ priv
->end
,
1097 fill_async_callback
,
1102 g_buffered_input_stream_real_fill_finish (GBufferedInputStream
*stream
,
1103 GAsyncResult
*result
,
1106 g_return_val_if_fail (g_task_is_valid (result
, stream
), -1);
1108 return g_task_propagate_int (G_TASK (result
), error
);
1113 gssize bytes_skipped
;
1118 free_skip_async_data (gpointer _data
)
1120 SkipAsyncData
*data
= _data
;
1121 g_slice_free (SkipAsyncData
, data
);
1125 large_skip_callback (GObject
*source_object
,
1126 GAsyncResult
*result
,
1129 GTask
*task
= G_TASK (user_data
);
1130 SkipAsyncData
*data
;
1134 data
= g_task_get_task_data (task
);
1137 nread
= g_input_stream_skip_finish (G_INPUT_STREAM (source_object
),
1140 /* Only report the error if we've not already read some data */
1141 if (nread
< 0 && data
->bytes_skipped
== 0)
1142 g_task_return_error (task
, error
);
1146 g_error_free (error
);
1149 data
->bytes_skipped
+= nread
;
1151 g_task_return_int (task
, data
->bytes_skipped
);
1154 g_object_unref (task
);
1158 skip_fill_buffer_callback (GObject
*source_object
,
1159 GAsyncResult
*result
,
1162 GTask
*task
= G_TASK (user_data
);
1163 GBufferedInputStream
*bstream
;
1164 GBufferedInputStreamPrivate
*priv
;
1165 SkipAsyncData
*data
;
1170 bstream
= G_BUFFERED_INPUT_STREAM (source_object
);
1171 priv
= bstream
->priv
;
1173 data
= g_task_get_task_data (task
);
1176 nread
= g_buffered_input_stream_fill_finish (bstream
,
1179 if (nread
< 0 && data
->bytes_skipped
== 0)
1180 g_task_return_error (task
, error
);
1184 g_error_free (error
);
1188 available
= priv
->end
- priv
->pos
;
1189 data
->count
= MIN (data
->count
, available
);
1191 data
->bytes_skipped
+= data
->count
;
1192 priv
->pos
+= data
->count
;
1195 g_task_return_int (task
, data
->bytes_skipped
);
1198 g_object_unref (task
);
1202 g_buffered_input_stream_skip_async (GInputStream
*stream
,
1205 GCancellable
*cancellable
,
1206 GAsyncReadyCallback callback
,
1209 GBufferedInputStream
*bstream
;
1210 GBufferedInputStreamPrivate
*priv
;
1211 GBufferedInputStreamClass
*class;
1212 GInputStream
*base_stream
;
1215 SkipAsyncData
*data
;
1217 bstream
= G_BUFFERED_INPUT_STREAM (stream
);
1218 priv
= bstream
->priv
;
1220 data
= g_slice_new (SkipAsyncData
);
1221 data
->bytes_skipped
= 0;
1222 task
= g_task_new (stream
, cancellable
, callback
, user_data
);
1223 g_task_set_task_data (task
, data
, free_skip_async_data
);
1225 available
= priv
->end
- priv
->pos
;
1227 if (count
<= available
)
1231 g_task_return_int (task
, count
);
1232 g_object_unref (task
);
1236 /* Full request not available, skip all currently available
1237 * and request refill for more
1245 data
->bytes_skipped
= available
;
1246 data
->count
= count
;
1248 if (count
> priv
->len
)
1250 /* Large request, shortcut buffer */
1252 base_stream
= G_FILTER_INPUT_STREAM (stream
)->base_stream
;
1254 g_input_stream_skip_async (base_stream
,
1256 io_priority
, cancellable
,
1257 large_skip_callback
,
1262 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream
);
1263 class->fill_async (bstream
, priv
->len
, io_priority
, cancellable
,
1264 skip_fill_buffer_callback
, task
);
1269 g_buffered_input_stream_skip_finish (GInputStream
*stream
,
1270 GAsyncResult
*result
,
1273 g_return_val_if_fail (g_task_is_valid (result
, stream
), -1);
1275 return g_task_propagate_int (G_TASK (result
), error
);