Formatting cleanup
[glib.git] / gio / gbufferedinputstream.c
blobdbe96c770430704908a1f7f1517b3e8ec50f287d
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>
24 #include "config.h"
25 #include "gbufferedinputstream.h"
26 #include "ginputstream.h"
27 #include "gcancellable.h"
28 #include "gasyncresult.h"
29 #include "gsimpleasyncresult.h"
30 #include "gioerror.h"
31 #include <string.h>
32 #include "glibintl.h"
35 /**
36 * SECTION:gbufferedinputstream
37 * @short_description: Buffered Input Stream
38 * @include: gio/gio.h
39 * @see_also: #GFilterInputStream, #GInputStream
41 * Buffered input stream implements #GFilterInputStream and provides
42 * for buffered reads.
44 * By default, #GBufferedInputStream's buffer size is set at 4 kilobytes.
46 * To create a buffered input stream, use g_buffered_input_stream_new(),
47 * or g_buffered_input_stream_new_sized() to specify the buffer's size at
48 * construction.
50 * To get the size of a buffer within a buffered input stream, use
51 * g_buffered_input_stream_get_buffer_size(). To change the size of a
52 * buffered input stream's buffer, use
53 * g_buffered_input_stream_set_buffer_size(). Note that the buffer's size
54 * cannot be reduced below the size of the data within the buffer.
58 #define DEFAULT_BUFFER_SIZE 4096
60 struct _GBufferedInputStreamPrivate {
61 guint8 *buffer;
62 gsize len;
63 gsize pos;
64 gsize end;
65 GAsyncReadyCallback outstanding_callback;
68 enum {
69 PROP_0,
70 PROP_BUFSIZE
73 static void g_buffered_input_stream_set_property (GObject *object,
74 guint prop_id,
75 const GValue *value,
76 GParamSpec *pspec);
78 static void g_buffered_input_stream_get_property (GObject *object,
79 guint prop_id,
80 GValue *value,
81 GParamSpec *pspec);
82 static void g_buffered_input_stream_finalize (GObject *object);
85 static gssize g_buffered_input_stream_skip (GInputStream *stream,
86 gsize count,
87 GCancellable *cancellable,
88 GError **error);
89 static void g_buffered_input_stream_skip_async (GInputStream *stream,
90 gsize count,
91 int io_priority,
92 GCancellable *cancellable,
93 GAsyncReadyCallback callback,
94 gpointer user_data);
95 static gssize g_buffered_input_stream_skip_finish (GInputStream *stream,
96 GAsyncResult *result,
97 GError **error);
98 static gssize g_buffered_input_stream_read (GInputStream *stream,
99 void *buffer,
100 gsize count,
101 GCancellable *cancellable,
102 GError **error);
103 static void g_buffered_input_stream_read_async (GInputStream *stream,
104 void *buffer,
105 gsize count,
106 int io_priority,
107 GCancellable *cancellable,
108 GAsyncReadyCallback callback,
109 gpointer user_data);
110 static gssize g_buffered_input_stream_read_finish (GInputStream *stream,
111 GAsyncResult *result,
112 GError **error);
113 static gssize g_buffered_input_stream_real_fill (GBufferedInputStream *stream,
114 gssize count,
115 GCancellable *cancellable,
116 GError **error);
117 static void g_buffered_input_stream_real_fill_async (GBufferedInputStream *stream,
118 gssize count,
119 int io_priority,
120 GCancellable *cancellable,
121 GAsyncReadyCallback callback,
122 gpointer user_data);
123 static gssize g_buffered_input_stream_real_fill_finish (GBufferedInputStream *stream,
124 GAsyncResult *result,
125 GError **error);
127 static void compact_buffer (GBufferedInputStream *stream);
129 G_DEFINE_TYPE (GBufferedInputStream,
130 g_buffered_input_stream,
131 G_TYPE_FILTER_INPUT_STREAM)
134 static void
135 g_buffered_input_stream_class_init (GBufferedInputStreamClass *klass)
137 GObjectClass *object_class;
138 GInputStreamClass *istream_class;
139 GBufferedInputStreamClass *bstream_class;
141 g_type_class_add_private (klass, sizeof (GBufferedInputStreamPrivate));
143 object_class = G_OBJECT_CLASS (klass);
144 object_class->get_property = g_buffered_input_stream_get_property;
145 object_class->set_property = g_buffered_input_stream_set_property;
146 object_class->finalize = g_buffered_input_stream_finalize;
148 istream_class = G_INPUT_STREAM_CLASS (klass);
149 istream_class->skip = g_buffered_input_stream_skip;
150 istream_class->skip_async = g_buffered_input_stream_skip_async;
151 istream_class->skip_finish = g_buffered_input_stream_skip_finish;
152 istream_class->read_fn = g_buffered_input_stream_read;
153 istream_class->read_async = g_buffered_input_stream_read_async;
154 istream_class->read_finish = g_buffered_input_stream_read_finish;
156 bstream_class = G_BUFFERED_INPUT_STREAM_CLASS (klass);
157 bstream_class->fill = g_buffered_input_stream_real_fill;
158 bstream_class->fill_async = g_buffered_input_stream_real_fill_async;
159 bstream_class->fill_finish = g_buffered_input_stream_real_fill_finish;
161 g_object_class_install_property (object_class,
162 PROP_BUFSIZE,
163 g_param_spec_uint ("buffer-size",
164 P_("Buffer Size"),
165 P_("The size of the backend buffer"),
167 G_MAXUINT,
168 DEFAULT_BUFFER_SIZE,
169 G_PARAM_READWRITE | G_PARAM_CONSTRUCT |
170 G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
176 * g_buffered_input_stream_get_buffer_size:
177 * @stream: a #GBufferedInputStream
179 * Gets the size of the input buffer.
181 * Returns: the current buffer size.
183 gsize
184 g_buffered_input_stream_get_buffer_size (GBufferedInputStream *stream)
186 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), 0);
188 return stream->priv->len;
192 * g_buffered_input_stream_set_buffer_size:
193 * @stream: a #GBufferedInputStream
194 * @size: a #gsize
196 * Sets the size of the internal buffer of @stream to @size, or to the
197 * size of the contents of the buffer. The buffer can never be resized
198 * smaller than its current contents.
200 void
201 g_buffered_input_stream_set_buffer_size (GBufferedInputStream *stream,
202 gsize size)
204 GBufferedInputStreamPrivate *priv;
205 gsize in_buffer;
206 guint8 *buffer;
208 g_return_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream));
210 priv = stream->priv;
212 if (priv->len == size)
213 return;
215 if (priv->buffer)
217 in_buffer = priv->end - priv->pos;
219 /* Never resize smaller than current buffer contents */
220 size = MAX (size, in_buffer);
222 buffer = g_malloc (size);
223 memcpy (buffer, priv->buffer + priv->pos, in_buffer);
224 priv->len = size;
225 priv->pos = 0;
226 priv->end = in_buffer;
227 g_free (priv->buffer);
228 priv->buffer = buffer;
230 else
232 priv->len = size;
233 priv->pos = 0;
234 priv->end = 0;
235 priv->buffer = g_malloc (size);
238 g_object_notify (G_OBJECT (stream), "buffer-size");
241 static void
242 g_buffered_input_stream_set_property (GObject *object,
243 guint prop_id,
244 const GValue *value,
245 GParamSpec *pspec)
247 GBufferedInputStream *bstream;
249 bstream = G_BUFFERED_INPUT_STREAM (object);
251 switch (prop_id)
253 case PROP_BUFSIZE:
254 g_buffered_input_stream_set_buffer_size (bstream, g_value_get_uint (value));
255 break;
257 default:
258 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
259 break;
263 static void
264 g_buffered_input_stream_get_property (GObject *object,
265 guint prop_id,
266 GValue *value,
267 GParamSpec *pspec)
269 GBufferedInputStreamPrivate *priv;
270 GBufferedInputStream *bstream;
272 bstream = G_BUFFERED_INPUT_STREAM (object);
273 priv = bstream->priv;
275 switch (prop_id)
277 case PROP_BUFSIZE:
278 g_value_set_uint (value, priv->len);
279 break;
281 default:
282 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
283 break;
287 static void
288 g_buffered_input_stream_finalize (GObject *object)
290 GBufferedInputStreamPrivate *priv;
291 GBufferedInputStream *stream;
293 stream = G_BUFFERED_INPUT_STREAM (object);
294 priv = stream->priv;
296 g_free (priv->buffer);
298 G_OBJECT_CLASS (g_buffered_input_stream_parent_class)->finalize (object);
301 static void
302 g_buffered_input_stream_init (GBufferedInputStream *stream)
304 stream->priv = G_TYPE_INSTANCE_GET_PRIVATE (stream,
305 G_TYPE_BUFFERED_INPUT_STREAM,
306 GBufferedInputStreamPrivate);
311 * g_buffered_input_stream_new:
312 * @base_stream: a #GInputStream
314 * Creates a new #GInputStream from the given @base_stream, with
315 * a buffer set to the default size (4 kilobytes).
317 * Returns: a #GInputStream for the given @base_stream.
319 GInputStream *
320 g_buffered_input_stream_new (GInputStream *base_stream)
322 GInputStream *stream;
324 g_return_val_if_fail (G_IS_INPUT_STREAM (base_stream), NULL);
326 stream = g_object_new (G_TYPE_BUFFERED_INPUT_STREAM,
327 "base-stream", base_stream,
328 NULL);
330 return stream;
334 * g_buffered_input_stream_new_sized:
335 * @base_stream: a #GInputStream
336 * @size: a #gsize
338 * Creates a new #GBufferedInputStream from the given @base_stream,
339 * with a buffer set to @size.
341 * Returns: a #GInputStream.
343 GInputStream *
344 g_buffered_input_stream_new_sized (GInputStream *base_stream,
345 gsize size)
347 GInputStream *stream;
349 g_return_val_if_fail (G_IS_INPUT_STREAM (base_stream), NULL);
351 stream = g_object_new (G_TYPE_BUFFERED_INPUT_STREAM,
352 "base-stream", base_stream,
353 "buffer-size", (guint)size,
354 NULL);
356 return stream;
360 * g_buffered_input_stream_fill:
361 * @stream: a #GBufferedInputStream
362 * @count: the number of bytes that will be read from the stream
363 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
364 * @error: location to store the error occurring, or %NULL to ignore
366 * Tries to read @count bytes from the stream into the buffer.
367 * Will block during this read.
369 * If @count is zero, returns zero and does nothing. A value of @count
370 * larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
372 * On success, the number of bytes read into the buffer is returned.
373 * It is not an error if this is not the same as the requested size, as it
374 * can happen e.g. near the end of a file. Zero is returned on end of file
375 * (or if @count is zero), but never otherwise.
377 * If @count is -1 then the attempted read size is equal to the number of
378 * bytes that are required to fill the buffer.
380 * If @cancellable is not %NULL, then the operation can be cancelled by
381 * triggering the cancellable object from another thread. If the operation
382 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
383 * operation was partially finished when the operation was cancelled the
384 * partial result will be returned, without an error.
386 * On error -1 is returned and @error is set accordingly.
388 * For the asynchronous, non-blocking, version of this function, see
389 * g_buffered_input_stream_fill_async().
391 * Returns: the number of bytes read into @stream's buffer, up to @count,
392 * or -1 on error.
394 gssize
395 g_buffered_input_stream_fill (GBufferedInputStream *stream,
396 gssize count,
397 GCancellable *cancellable,
398 GError **error)
400 GBufferedInputStreamClass *class;
401 GInputStream *input_stream;
402 gssize res;
404 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), -1);
406 input_stream = G_INPUT_STREAM (stream);
408 if (count < -1)
410 g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
411 _("Too large count value passed to %s"), G_STRFUNC);
412 return -1;
415 if (!g_input_stream_set_pending (input_stream, error))
416 return -1;
418 if (cancellable)
419 g_cancellable_push_current (cancellable);
421 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
422 res = class->fill (stream, count, cancellable, error);
424 if (cancellable)
425 g_cancellable_pop_current (cancellable);
427 g_input_stream_clear_pending (input_stream);
429 return res;
432 static void
433 async_fill_callback_wrapper (GObject *source_object,
434 GAsyncResult *res,
435 gpointer user_data)
437 GBufferedInputStream *stream = G_BUFFERED_INPUT_STREAM (source_object);
439 g_input_stream_clear_pending (G_INPUT_STREAM (stream));
440 (*stream->priv->outstanding_callback) (source_object, res, user_data);
441 g_object_unref (stream);
445 * g_buffered_input_stream_fill_async:
446 * @stream: a #GBufferedInputStream
447 * @count: the number of bytes that will be read from the stream
448 * @io_priority: the <link linkend="io-priority">I/O priority</link>
449 * of the request
450 * @cancellable: (allow-none): optional #GCancellable object
451 * @callback: (scope async): a #GAsyncReadyCallback
452 * @user_data: (closure): a #gpointer
454 * Reads data into @stream's buffer asynchronously, up to @count size.
455 * @io_priority can be used to prioritize reads. For the synchronous
456 * version of this function, see g_buffered_input_stream_fill().
458 * If @count is -1 then the attempted read size is equal to the number
459 * of bytes that are required to fill the buffer.
461 void
462 g_buffered_input_stream_fill_async (GBufferedInputStream *stream,
463 gssize count,
464 int io_priority,
465 GCancellable *cancellable,
466 GAsyncReadyCallback callback,
467 gpointer user_data)
469 GBufferedInputStreamClass *class;
470 GSimpleAsyncResult *simple;
471 GError *error = NULL;
473 g_return_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream));
475 if (count == 0)
477 simple = g_simple_async_result_new (G_OBJECT (stream),
478 callback,
479 user_data,
480 g_buffered_input_stream_fill_async);
481 g_simple_async_result_complete_in_idle (simple);
482 g_object_unref (simple);
483 return;
486 if (count < -1)
488 g_simple_async_report_error_in_idle (G_OBJECT (stream),
489 callback,
490 user_data,
491 G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
492 _("Too large count value passed to %s"),
493 G_STRFUNC);
494 return;
497 if (!g_input_stream_set_pending (G_INPUT_STREAM (stream), &error))
499 g_simple_async_report_take_gerror_in_idle (G_OBJECT (stream),
500 callback,
501 user_data,
502 error);
503 return;
506 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
508 stream->priv->outstanding_callback = callback;
509 g_object_ref (stream);
510 class->fill_async (stream, count, io_priority, cancellable,
511 async_fill_callback_wrapper, user_data);
515 * g_buffered_input_stream_fill_finish:
516 * @stream: a #GBufferedInputStream
517 * @result: a #GAsyncResult
518 * @error: a #GError
520 * Finishes an asynchronous read.
522 * Returns: a #gssize of the read stream, or %-1 on an error.
524 gssize
525 g_buffered_input_stream_fill_finish (GBufferedInputStream *stream,
526 GAsyncResult *result,
527 GError **error)
529 GSimpleAsyncResult *simple;
530 GBufferedInputStreamClass *class;
532 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), -1);
533 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), -1);
535 if (G_IS_SIMPLE_ASYNC_RESULT (result))
537 simple = G_SIMPLE_ASYNC_RESULT (result);
538 if (g_simple_async_result_propagate_error (simple, error))
539 return -1;
541 /* Special case read of 0 bytes */
542 if (g_simple_async_result_get_source_tag (simple) == g_buffered_input_stream_fill_async)
543 return 0;
546 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
547 return class->fill_finish (stream, result, error);
551 * g_buffered_input_stream_get_available:
552 * @stream: #GBufferedInputStream
554 * Gets the size of the available data within the stream.
556 * Returns: size of the available stream.
558 gsize
559 g_buffered_input_stream_get_available (GBufferedInputStream *stream)
561 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), -1);
563 return stream->priv->end - stream->priv->pos;
567 * g_buffered_input_stream_peek:
568 * @stream: a #GBufferedInputStream
569 * @buffer: (array length=count) (element-type guint8): a pointer to
570 * an allocated chunk of memory
571 * @offset: a #gsize
572 * @count: a #gsize
574 * Peeks in the buffer, copying data of size @count into @buffer,
575 * offset @offset bytes.
577 * Returns: a #gsize of the number of bytes peeked, or -1 on error.
579 gsize
580 g_buffered_input_stream_peek (GBufferedInputStream *stream,
581 void *buffer,
582 gsize offset,
583 gsize count)
585 gsize available;
586 gsize end;
588 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), -1);
589 g_return_val_if_fail (buffer != NULL, -1);
591 available = g_buffered_input_stream_get_available (stream);
593 if (offset > available)
594 return 0;
596 end = MIN (offset + count, available);
597 count = end - offset;
599 memcpy (buffer, stream->priv->buffer + stream->priv->pos + offset, count);
600 return count;
604 * g_buffered_input_stream_peek_buffer:
605 * @stream: a #GBufferedInputStream
606 * @count: (out): a #gsize to get the number of bytes available in the buffer
608 * Returns the buffer with the currently available bytes. The returned
609 * buffer must not be modified and will become invalid when reading from
610 * the stream or filling the buffer.
612 * Returns: (array length=count) (element-type guint8) (transfer none):
613 * read-only buffer
615 const void*
616 g_buffered_input_stream_peek_buffer (GBufferedInputStream *stream,
617 gsize *count)
619 GBufferedInputStreamPrivate *priv;
621 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), NULL);
623 priv = stream->priv;
625 if (count)
626 *count = priv->end - priv->pos;
628 return priv->buffer + priv->pos;
631 static void
632 compact_buffer (GBufferedInputStream *stream)
634 GBufferedInputStreamPrivate *priv;
635 gsize current_size;
637 priv = stream->priv;
639 current_size = priv->end - priv->pos;
641 g_memmove (priv->buffer, priv->buffer + priv->pos, current_size);
643 priv->pos = 0;
644 priv->end = current_size;
647 static gssize
648 g_buffered_input_stream_real_fill (GBufferedInputStream *stream,
649 gssize count,
650 GCancellable *cancellable,
651 GError **error)
653 GBufferedInputStreamPrivate *priv;
654 GInputStream *base_stream;
655 gssize nread;
656 gsize in_buffer;
658 priv = stream->priv;
660 if (count == -1)
661 count = priv->len;
663 in_buffer = priv->end - priv->pos;
665 /* Never fill more than can fit in the buffer */
666 count = MIN (count, priv->len - in_buffer);
668 /* If requested length does not fit at end, compact */
669 if (priv->len - priv->end < count)
670 compact_buffer (stream);
672 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
673 nread = g_input_stream_read (base_stream,
674 priv->buffer + priv->end,
675 count,
676 cancellable,
677 error);
679 if (nread > 0)
680 priv->end += nread;
682 return nread;
685 static gssize
686 g_buffered_input_stream_skip (GInputStream *stream,
687 gsize count,
688 GCancellable *cancellable,
689 GError **error)
691 GBufferedInputStream *bstream;
692 GBufferedInputStreamPrivate *priv;
693 GBufferedInputStreamClass *class;
694 GInputStream *base_stream;
695 gsize available, bytes_skipped;
696 gssize nread;
698 bstream = G_BUFFERED_INPUT_STREAM (stream);
699 priv = bstream->priv;
701 available = priv->end - priv->pos;
703 if (count <= available)
705 priv->pos += count;
706 return count;
709 /* Full request not available, skip all currently available and
710 * request refill for more
713 priv->pos = 0;
714 priv->end = 0;
715 bytes_skipped = available;
716 count -= available;
718 if (bytes_skipped > 0)
719 error = NULL; /* Ignore further errors if we already read some data */
721 if (count > priv->len)
723 /* Large request, shortcut buffer */
725 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
727 nread = g_input_stream_skip (base_stream,
728 count,
729 cancellable,
730 error);
732 if (nread < 0 && bytes_skipped == 0)
733 return -1;
735 if (nread > 0)
736 bytes_skipped += nread;
738 return bytes_skipped;
741 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
742 nread = class->fill (bstream, priv->len, cancellable, error);
744 if (nread < 0)
746 if (bytes_skipped == 0)
747 return -1;
748 else
749 return bytes_skipped;
752 available = priv->end - priv->pos;
753 count = MIN (count, available);
755 bytes_skipped += count;
756 priv->pos += count;
758 return bytes_skipped;
761 static gssize
762 g_buffered_input_stream_read (GInputStream *stream,
763 void *buffer,
764 gsize count,
765 GCancellable *cancellable,
766 GError **error)
768 GBufferedInputStream *bstream;
769 GBufferedInputStreamPrivate *priv;
770 GBufferedInputStreamClass *class;
771 GInputStream *base_stream;
772 gsize available, bytes_read;
773 gssize nread;
775 bstream = G_BUFFERED_INPUT_STREAM (stream);
776 priv = bstream->priv;
778 available = priv->end - priv->pos;
780 if (count <= available)
782 memcpy (buffer, priv->buffer + priv->pos, count);
783 priv->pos += count;
784 return count;
787 /* Full request not available, read all currently available and
788 * request refill for more
791 memcpy (buffer, priv->buffer + priv->pos, available);
792 priv->pos = 0;
793 priv->end = 0;
794 bytes_read = available;
795 count -= available;
797 if (bytes_read > 0)
798 error = NULL; /* Ignore further errors if we already read some data */
800 if (count > priv->len)
802 /* Large request, shortcut buffer */
804 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
806 nread = g_input_stream_read (base_stream,
807 (char *)buffer + bytes_read,
808 count,
809 cancellable,
810 error);
812 if (nread < 0 && bytes_read == 0)
813 return -1;
815 if (nread > 0)
816 bytes_read += nread;
818 return bytes_read;
821 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
822 nread = class->fill (bstream, priv->len, cancellable, error);
823 if (nread < 0)
825 if (bytes_read == 0)
826 return -1;
827 else
828 return bytes_read;
831 available = priv->end - priv->pos;
832 count = MIN (count, available);
834 memcpy ((char *)buffer + bytes_read, (char *)priv->buffer + priv->pos, count);
835 bytes_read += count;
836 priv->pos += count;
838 return bytes_read;
842 * g_buffered_input_stream_read_byte:
843 * @stream: a #GBufferedInputStream
844 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
845 * @error: location to store the error occurring, or %NULL to ignore
847 * Tries to read a single byte from the stream or the buffer. Will block
848 * during this read.
850 * On success, the byte read from the stream is returned. On end of stream
851 * -1 is returned but it's not an exceptional error and @error is not set.
853 * If @cancellable is not %NULL, then the operation can be cancelled by
854 * triggering the cancellable object from another thread. If the operation
855 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
856 * operation was partially finished when the operation was cancelled the
857 * partial result will be returned, without an error.
859 * On error -1 is returned and @error is set accordingly.
861 * Returns: the byte read from the @stream, or -1 on end of stream or error.
864 g_buffered_input_stream_read_byte (GBufferedInputStream *stream,
865 GCancellable *cancellable,
866 GError **error)
868 GBufferedInputStreamPrivate *priv;
869 GBufferedInputStreamClass *class;
870 GInputStream *input_stream;
871 gsize available;
872 gssize nread;
874 g_return_val_if_fail (G_IS_BUFFERED_INPUT_STREAM (stream), -1);
876 priv = stream->priv;
877 input_stream = G_INPUT_STREAM (stream);
879 if (g_input_stream_is_closed (input_stream))
881 g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_CLOSED,
882 _("Stream is already closed"));
883 return -1;
886 if (!g_input_stream_set_pending (input_stream, error))
887 return -1;
889 available = priv->end - priv->pos;
891 if (available != 0)
893 g_input_stream_clear_pending (input_stream);
894 return priv->buffer[priv->pos++];
897 /* Byte not available, request refill for more */
899 if (cancellable)
900 g_cancellable_push_current (cancellable);
902 priv->pos = 0;
903 priv->end = 0;
905 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
906 nread = class->fill (stream, priv->len, cancellable, error);
908 if (cancellable)
909 g_cancellable_pop_current (cancellable);
911 g_input_stream_clear_pending (input_stream);
913 if (nread <= 0)
914 return -1; /* error or end of stream */
916 return priv->buffer[priv->pos++];
919 /* ************************** */
920 /* Async stuff implementation */
921 /* ************************** */
923 static void
924 fill_async_callback (GObject *source_object,
925 GAsyncResult *result,
926 gpointer user_data)
928 GError *error;
929 gssize res;
930 GSimpleAsyncResult *simple;
932 simple = user_data;
934 error = NULL;
935 res = g_input_stream_read_finish (G_INPUT_STREAM (source_object),
936 result, &error);
938 g_simple_async_result_set_op_res_gssize (simple, res);
939 if (res == -1)
941 g_simple_async_result_take_error (simple, error);
943 else
945 GBufferedInputStreamPrivate *priv;
946 GObject *object;
948 object = g_async_result_get_source_object (G_ASYNC_RESULT (simple));
949 priv = G_BUFFERED_INPUT_STREAM (object)->priv;
951 g_assert_cmpint (priv->end + res, <=, priv->len);
952 priv->end += res;
954 g_object_unref (object);
957 /* Complete immediately, not in idle, since we're already
958 * in a mainloop callout
960 g_simple_async_result_complete (simple);
961 g_object_unref (simple);
964 static void
965 g_buffered_input_stream_real_fill_async (GBufferedInputStream *stream,
966 gssize count,
967 int io_priority,
968 GCancellable *cancellable,
969 GAsyncReadyCallback callback,
970 gpointer user_data)
972 GBufferedInputStreamPrivate *priv;
973 GInputStream *base_stream;
974 GSimpleAsyncResult *simple;
975 gsize in_buffer;
977 priv = stream->priv;
979 if (count == -1)
980 count = priv->len;
982 in_buffer = priv->end - priv->pos;
984 /* Never fill more than can fit in the buffer */
985 count = MIN (count, priv->len - in_buffer);
987 /* If requested length does not fit at end, compact */
988 if (priv->len - priv->end < count)
989 compact_buffer (stream);
991 simple = g_simple_async_result_new (G_OBJECT (stream),
992 callback, user_data,
993 g_buffered_input_stream_real_fill_async);
995 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
996 g_input_stream_read_async (base_stream,
997 priv->buffer + priv->end,
998 count,
999 io_priority,
1000 cancellable,
1001 fill_async_callback,
1002 simple);
1005 static gssize
1006 g_buffered_input_stream_real_fill_finish (GBufferedInputStream *stream,
1007 GAsyncResult *result,
1008 GError **error)
1010 GSimpleAsyncResult *simple;
1011 gssize nread;
1013 simple = G_SIMPLE_ASYNC_RESULT (result);
1014 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) == g_buffered_input_stream_real_fill_async);
1016 nread = g_simple_async_result_get_op_res_gssize (simple);
1017 return nread;
1020 typedef struct
1022 gssize bytes_read;
1023 gssize count;
1024 void *buffer;
1025 } ReadAsyncData;
1027 static void
1028 free_read_async_data (gpointer _data)
1030 ReadAsyncData *data = _data;
1031 g_slice_free (ReadAsyncData, data);
1034 static void
1035 large_read_callback (GObject *source_object,
1036 GAsyncResult *result,
1037 gpointer user_data)
1039 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (user_data);
1040 ReadAsyncData *data;
1041 GError *error;
1042 gssize nread;
1044 data = g_simple_async_result_get_op_res_gpointer (simple);
1046 error = NULL;
1047 nread = g_input_stream_read_finish (G_INPUT_STREAM (source_object),
1048 result, &error);
1050 /* Only report the error if we've not already read some data */
1051 if (nread < 0 && data->bytes_read == 0)
1052 g_simple_async_result_take_error (simple, error);
1053 else if (error)
1054 g_error_free (error);
1056 if (nread > 0)
1057 data->bytes_read += nread;
1059 /* Complete immediately, not in idle, since we're already
1060 * in a mainloop callout
1062 g_simple_async_result_complete (simple);
1063 g_object_unref (simple);
1066 static void
1067 read_fill_buffer_callback (GObject *source_object,
1068 GAsyncResult *result,
1069 gpointer user_data)
1071 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (user_data);
1072 GBufferedInputStream *bstream;
1073 GBufferedInputStreamPrivate *priv;
1074 ReadAsyncData *data;
1075 GError *error;
1076 gssize nread;
1077 gsize available;
1079 bstream = G_BUFFERED_INPUT_STREAM (source_object);
1080 priv = bstream->priv;
1082 data = g_simple_async_result_get_op_res_gpointer (simple);
1084 error = NULL;
1085 nread = g_buffered_input_stream_fill_finish (bstream,
1086 result, &error);
1088 if (nread < 0 && data->bytes_read == 0)
1089 g_simple_async_result_take_error (simple, error);
1090 else if (error)
1091 g_error_free (error);
1093 if (nread > 0)
1095 available = priv->end - priv->pos;
1096 data->count = MIN (data->count, available);
1098 memcpy ((char *)data->buffer + data->bytes_read, (char *)priv->buffer + priv->pos, data->count);
1099 data->bytes_read += data->count;
1100 priv->pos += data->count;
1103 /* Complete immediately, not in idle, since we're already
1104 * in a mainloop callout
1106 g_simple_async_result_complete (simple);
1107 g_object_unref (simple);
1110 static void
1111 g_buffered_input_stream_read_async (GInputStream *stream,
1112 void *buffer,
1113 gsize count,
1114 int io_priority,
1115 GCancellable *cancellable,
1116 GAsyncReadyCallback callback,
1117 gpointer user_data)
1119 GBufferedInputStream *bstream;
1120 GBufferedInputStreamPrivate *priv;
1121 GBufferedInputStreamClass *class;
1122 GInputStream *base_stream;
1123 gsize available;
1124 GSimpleAsyncResult *simple;
1125 ReadAsyncData *data;
1127 bstream = G_BUFFERED_INPUT_STREAM (stream);
1128 priv = bstream->priv;
1130 data = g_slice_new (ReadAsyncData);
1131 data->buffer = buffer;
1132 data->bytes_read = 0;
1133 simple = g_simple_async_result_new (G_OBJECT (stream),
1134 callback, user_data,
1135 g_buffered_input_stream_read_async);
1136 g_simple_async_result_set_op_res_gpointer (simple, data, free_read_async_data);
1138 available = priv->end - priv->pos;
1140 if (count <= available)
1142 memcpy (buffer, priv->buffer + priv->pos, count);
1143 priv->pos += count;
1144 data->bytes_read = count;
1146 g_simple_async_result_complete_in_idle (simple);
1147 g_object_unref (simple);
1148 return;
1152 /* Full request not available, read all currently available
1153 * and request refill for more
1156 memcpy (buffer, priv->buffer + priv->pos, available);
1157 priv->pos = 0;
1158 priv->end = 0;
1160 count -= available;
1162 data->bytes_read = available;
1163 data->count = count;
1165 if (count > priv->len)
1167 /* Large request, shortcut buffer */
1169 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
1171 g_input_stream_read_async (base_stream,
1172 (char *)buffer + data->bytes_read,
1173 count,
1174 io_priority, cancellable,
1175 large_read_callback,
1176 simple);
1178 else
1180 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
1181 class->fill_async (bstream, priv->len, io_priority, cancellable,
1182 read_fill_buffer_callback, simple);
1186 static gssize
1187 g_buffered_input_stream_read_finish (GInputStream *stream,
1188 GAsyncResult *result,
1189 GError **error)
1191 GSimpleAsyncResult *simple;
1192 ReadAsyncData *data;
1194 simple = G_SIMPLE_ASYNC_RESULT (result);
1196 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) == g_buffered_input_stream_read_async);
1198 data = g_simple_async_result_get_op_res_gpointer (simple);
1200 return data->bytes_read;
1203 typedef struct
1205 gssize bytes_skipped;
1206 gssize count;
1207 } SkipAsyncData;
1209 static void
1210 free_skip_async_data (gpointer _data)
1212 SkipAsyncData *data = _data;
1213 g_slice_free (SkipAsyncData, data);
1216 static void
1217 large_skip_callback (GObject *source_object,
1218 GAsyncResult *result,
1219 gpointer user_data)
1221 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (user_data);
1222 SkipAsyncData *data;
1223 GError *error;
1224 gssize nread;
1226 data = g_simple_async_result_get_op_res_gpointer (simple);
1228 error = NULL;
1229 nread = g_input_stream_skip_finish (G_INPUT_STREAM (source_object),
1230 result, &error);
1232 /* Only report the error if we've not already read some data */
1233 if (nread < 0 && data->bytes_skipped == 0)
1234 g_simple_async_result_take_error (simple, error);
1235 else if (error)
1236 g_error_free (error);
1238 if (nread > 0)
1239 data->bytes_skipped += nread;
1241 /* Complete immediately, not in idle, since we're already
1242 * in a mainloop callout
1244 g_simple_async_result_complete (simple);
1245 g_object_unref (simple);
1248 static void
1249 skip_fill_buffer_callback (GObject *source_object,
1250 GAsyncResult *result,
1251 gpointer user_data)
1253 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (user_data);
1254 GBufferedInputStream *bstream;
1255 GBufferedInputStreamPrivate *priv;
1256 SkipAsyncData *data;
1257 GError *error;
1258 gssize nread;
1259 gsize available;
1261 bstream = G_BUFFERED_INPUT_STREAM (source_object);
1262 priv = bstream->priv;
1264 data = g_simple_async_result_get_op_res_gpointer (simple);
1266 error = NULL;
1267 nread = g_buffered_input_stream_fill_finish (bstream,
1268 result, &error);
1270 if (nread < 0 && data->bytes_skipped == 0)
1271 g_simple_async_result_take_error (simple, error);
1272 else if (error)
1273 g_error_free (error);
1275 if (nread > 0)
1277 available = priv->end - priv->pos;
1278 data->count = MIN (data->count, available);
1280 data->bytes_skipped += data->count;
1281 priv->pos += data->count;
1284 /* Complete immediately, not in idle, since we're already
1285 * in a mainloop callout
1287 g_simple_async_result_complete (simple);
1288 g_object_unref (simple);
1291 static void
1292 g_buffered_input_stream_skip_async (GInputStream *stream,
1293 gsize count,
1294 int io_priority,
1295 GCancellable *cancellable,
1296 GAsyncReadyCallback callback,
1297 gpointer user_data)
1299 GBufferedInputStream *bstream;
1300 GBufferedInputStreamPrivate *priv;
1301 GBufferedInputStreamClass *class;
1302 GInputStream *base_stream;
1303 gsize available;
1304 GSimpleAsyncResult *simple;
1305 SkipAsyncData *data;
1307 bstream = G_BUFFERED_INPUT_STREAM (stream);
1308 priv = bstream->priv;
1310 data = g_slice_new (SkipAsyncData);
1311 data->bytes_skipped = 0;
1312 simple = g_simple_async_result_new (G_OBJECT (stream),
1313 callback, user_data,
1314 g_buffered_input_stream_skip_async);
1315 g_simple_async_result_set_op_res_gpointer (simple, data, free_skip_async_data);
1317 available = priv->end - priv->pos;
1319 if (count <= available)
1321 priv->pos += count;
1322 data->bytes_skipped = count;
1324 g_simple_async_result_complete_in_idle (simple);
1325 g_object_unref (simple);
1326 return;
1329 /* Full request not available, skip all currently available
1330 * and request refill for more
1333 priv->pos = 0;
1334 priv->end = 0;
1336 count -= available;
1338 data->bytes_skipped = available;
1339 data->count = count;
1341 if (count > priv->len)
1343 /* Large request, shortcut buffer */
1345 base_stream = G_FILTER_INPUT_STREAM (stream)->base_stream;
1347 g_input_stream_skip_async (base_stream,
1348 count,
1349 io_priority, cancellable,
1350 large_skip_callback,
1351 simple);
1353 else
1355 class = G_BUFFERED_INPUT_STREAM_GET_CLASS (stream);
1356 class->fill_async (bstream, priv->len, io_priority, cancellable,
1357 skip_fill_buffer_callback, simple);
1361 static gssize
1362 g_buffered_input_stream_skip_finish (GInputStream *stream,
1363 GAsyncResult *result,
1364 GError **error)
1366 GSimpleAsyncResult *simple;
1367 SkipAsyncData *data;
1369 simple = G_SIMPLE_ASYNC_RESULT (result);
1371 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) == g_buffered_input_stream_skip_async);
1373 data = g_simple_async_result_get_op_res_gpointer (simple);
1375 return data->bytes_skipped;