1 /* GIO - GLib Input, Output and Streaming Library
3 * Copyright (C) 2006-2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: Alexander Larsson <alexl@redhat.com>
27 #include "ginputstream.h"
28 #include "gseekable.h"
29 #include "gcancellable.h"
30 #include "gasyncresult.h"
31 #include "gsimpleasyncresult.h"
33 #include "gpollableinputstream.h"
36 * SECTION:ginputstream
37 * @short_description: Base class for implementing streaming input
40 * #GInputStream has functions to read from a stream (g_input_stream_read()),
41 * to close a stream (g_input_stream_close()) and to skip some content
42 * (g_input_stream_skip()).
44 * To copy the content of an input stream to an output stream without
45 * manually handling the reads and writes, use g_output_stream_splice().
47 * All of these functions have async variants too.
50 G_DEFINE_ABSTRACT_TYPE (GInputStream, g_input_stream, G_TYPE_OBJECT);
52 struct _GInputStreamPrivate {
55 GAsyncReadyCallback outstanding_callback;
58 static gssize g_input_stream_real_skip (GInputStream *stream,
60 GCancellable *cancellable,
62 static void g_input_stream_real_read_async (GInputStream *stream,
66 GCancellable *cancellable,
67 GAsyncReadyCallback callback,
69 static gssize g_input_stream_real_read_finish (GInputStream *stream,
72 static void g_input_stream_real_skip_async (GInputStream *stream,
75 GCancellable *cancellable,
76 GAsyncReadyCallback callback,
78 static gssize g_input_stream_real_skip_finish (GInputStream *stream,
81 static void g_input_stream_real_close_async (GInputStream *stream,
83 GCancellable *cancellable,
84 GAsyncReadyCallback callback,
86 static gboolean g_input_stream_real_close_finish (GInputStream *stream,
91 g_input_stream_finalize (GObject *object)
93 G_OBJECT_CLASS (g_input_stream_parent_class)->finalize (object);
97 g_input_stream_dispose (GObject *object)
101 stream = G_INPUT_STREAM (object);
103 if (!stream->priv->closed)
104 g_input_stream_close (stream, NULL, NULL);
106 G_OBJECT_CLASS (g_input_stream_parent_class)->dispose (object);
111 g_input_stream_class_init (GInputStreamClass *klass)
113 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
115 g_type_class_add_private (klass, sizeof (GInputStreamPrivate));
117 gobject_class->finalize = g_input_stream_finalize;
118 gobject_class->dispose = g_input_stream_dispose;
120 klass->skip = g_input_stream_real_skip;
121 klass->read_async = g_input_stream_real_read_async;
122 klass->read_finish = g_input_stream_real_read_finish;
123 klass->skip_async = g_input_stream_real_skip_async;
124 klass->skip_finish = g_input_stream_real_skip_finish;
125 klass->close_async = g_input_stream_real_close_async;
126 klass->close_finish = g_input_stream_real_close_finish;
130 g_input_stream_init (GInputStream *stream)
132 stream->priv = G_TYPE_INSTANCE_GET_PRIVATE (stream,
134 GInputStreamPrivate);
138 * g_input_stream_read:
139 * @stream: a #GInputStream.
140 * @buffer: a buffer to read data into (which should be at least count bytes long).
141 * @count: the number of bytes that will be read from the stream
142 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
143 * @error: location to store the error occurring, or %NULL to ignore
145 * Tries to read @count bytes from the stream into the buffer starting at
146 * @buffer. Will block during this read.
148 * If count is zero returns zero and does nothing. A value of @count
149 * larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
151 * On success, the number of bytes read into the buffer is returned.
152 * It is not an error if this is not the same as the requested size, as it
153 * can happen e.g. near the end of a file. Zero is returned on end of file
154 * (or if @count is zero), but never otherwise.
156 * If @cancellable is not %NULL, then the operation can be cancelled by
157 * triggering the cancellable object from another thread. If the operation
158 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
159 * operation was partially finished when the operation was cancelled the
160 * partial result will be returned, without an error.
162 * On error -1 is returned and @error is set accordingly.
164 * Return value: Number of bytes read, or -1 on error, or 0 on end of file.
167 g_input_stream_read (GInputStream *stream,
170 GCancellable *cancellable,
173 GInputStreamClass *class;
176 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), -1);
177 g_return_val_if_fail (buffer != NULL, 0);
182 if (((gssize) count) < 0)
184 g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
185 _("Too large count value passed to %s"), G_STRFUNC);
189 class = G_INPUT_STREAM_GET_CLASS (stream);
191 if (class->read_fn == NULL)
193 g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
194 _("Input stream doesn't implement read"));
198 if (!g_input_stream_set_pending (stream, error))
202 g_cancellable_push_current (cancellable);
204 res = class->read_fn (stream, buffer, count, cancellable, error);
207 g_cancellable_pop_current (cancellable);
209 g_input_stream_clear_pending (stream);
215 * g_input_stream_read_all:
216 * @stream: a #GInputStream.
217 * @buffer: a buffer to read data into (which should be at least count bytes long).
218 * @count: the number of bytes that will be read from the stream
219 * @bytes_read: (out): location to store the number of bytes that was read from the stream
220 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
221 * @error: location to store the error occurring, or %NULL to ignore
223 * Tries to read @count bytes from the stream into the buffer starting at
224 * @buffer. Will block during this read.
226 * This function is similar to g_input_stream_read(), except it tries to
227 * read as many bytes as requested, only stopping on an error or end of stream.
229 * On a successful read of @count bytes, or if we reached the end of the
230 * stream, %TRUE is returned, and @bytes_read is set to the number of bytes
233 * If there is an error during the operation %FALSE is returned and @error
234 * is set to indicate the error status, @bytes_read is updated to contain
235 * the number of bytes read into @buffer before the error occurred.
237 * Return value: %TRUE on success, %FALSE if there was an error
240 g_input_stream_read_all (GInputStream *stream,
244 GCancellable *cancellable,
250 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), FALSE);
251 g_return_val_if_fail (buffer != NULL, FALSE);
254 while (_bytes_read < count)
256 res = g_input_stream_read (stream, (char *)buffer + _bytes_read, count - _bytes_read,
261 *bytes_read = _bytes_read;
272 *bytes_read = _bytes_read;
277 * g_input_stream_read_bytes:
278 * @stream: a #GInputStream.
279 * @count: maximum number of bytes that will be read from the stream. Common
280 * values include 4096 and 8192.
281 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
282 * @error: location to store the error occurring, or %NULL to ignore
284 * Like g_input_stream_read(), this tries to read @count bytes from
285 * the stream in a blocking fashion. However, rather than reading into
286 * a user-supplied buffer, this will create a new #GBytes containing
287 * the data that was read. This may be easier to use from language
290 * If count is zero, returns a zero-length #GBytes and does nothing. A
291 * value of @count larger than %G_MAXSSIZE will cause a
292 * %G_IO_ERROR_INVALID_ARGUMENT error.
294 * On success, a new #GBytes is returned. It is not an error if the
295 * size of this object is not the same as the requested size, as it
296 * can happen e.g. near the end of a file. A zero-length #GBytes is
297 * returned on end of file (or if @count is zero), but never
300 * If @cancellable is not %NULL, then the operation can be cancelled by
301 * triggering the cancellable object from another thread. If the operation
302 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
303 * operation was partially finished when the operation was cancelled the
304 * partial result will be returned, without an error.
306 * On error %NULL is returned and @error is set accordingly.
308 * Return value: a new #GBytes, or %NULL on error
311 g_input_stream_read_bytes (GInputStream *stream,
313 GCancellable *cancellable,
319 buf = g_malloc (count);
320 nread = g_input_stream_read (stream, buf, count, cancellable, error);
329 return g_bytes_new_static ("", 0);
332 return g_bytes_new_take (buf, nread);
336 * g_input_stream_skip:
337 * @stream: a #GInputStream.
338 * @count: the number of bytes that will be skipped from the stream
339 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
340 * @error: location to store the error occurring, or %NULL to ignore
342 * Tries to skip @count bytes from the stream. Will block during the operation.
344 * This is identical to g_input_stream_read(), from a behaviour standpoint,
345 * but the bytes that are skipped are not returned to the user. Some
346 * streams have an implementation that is more efficient than reading the data.
348 * This function is optional for inherited classes, as the default implementation
349 * emulates it using read.
351 * If @cancellable is not %NULL, then the operation can be cancelled by
352 * triggering the cancellable object from another thread. If the operation
353 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
354 * operation was partially finished when the operation was cancelled the
355 * partial result will be returned, without an error.
357 * Return value: Number of bytes skipped, or -1 on error
360 g_input_stream_skip (GInputStream *stream,
362 GCancellable *cancellable,
365 GInputStreamClass *class;
368 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), -1);
373 if (((gssize) count) < 0)
375 g_set_error (error, G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
376 _("Too large count value passed to %s"), G_STRFUNC);
380 class = G_INPUT_STREAM_GET_CLASS (stream);
382 if (!g_input_stream_set_pending (stream, error))
386 g_cancellable_push_current (cancellable);
388 res = class->skip (stream, count, cancellable, error);
391 g_cancellable_pop_current (cancellable);
393 g_input_stream_clear_pending (stream);
399 g_input_stream_real_skip (GInputStream *stream,
401 GCancellable *cancellable,
404 GInputStreamClass *class;
405 gssize ret, read_bytes;
409 if (G_IS_SEEKABLE (stream) && g_seekable_can_seek (G_SEEKABLE (stream)))
411 if (g_seekable_seek (G_SEEKABLE (stream),
419 /* If not seekable, or seek failed, fall back to reading data: */
421 class = G_INPUT_STREAM_GET_CLASS (stream);
428 ret = class->read_fn (stream, buffer, MIN (sizeof (buffer), count),
429 cancellable, &my_error);
432 if (read_bytes > 0 &&
433 my_error->domain == G_IO_ERROR &&
434 my_error->code == G_IO_ERROR_CANCELLED)
436 g_error_free (my_error);
440 g_propagate_error (error, my_error);
447 if (ret == 0 || count == 0)
453 * g_input_stream_close:
454 * @stream: A #GInputStream.
455 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
456 * @error: location to store the error occurring, or %NULL to ignore
458 * Closes the stream, releasing resources related to it.
460 * Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
461 * Closing a stream multiple times will not return an error.
463 * Streams will be automatically closed when the last reference
464 * is dropped, but you might want to call this function to make sure
465 * resources are released as early as possible.
467 * Some streams might keep the backing store of the stream (e.g. a file descriptor)
468 * open after the stream is closed. See the documentation for the individual
469 * stream for details.
471 * On failure the first error that happened will be reported, but the close
472 * operation will finish as much as possible. A stream that failed to
473 * close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
474 * is important to check and report the error to the user.
476 * If @cancellable is not %NULL, then the operation can be cancelled by
477 * triggering the cancellable object from another thread. If the operation
478 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
479 * Cancelling a close will still leave the stream closed, but some streams
480 * can use a faster close that doesn't block to e.g. check errors.
482 * Return value: %TRUE on success, %FALSE on failure
485 g_input_stream_close (GInputStream *stream,
486 GCancellable *cancellable,
489 GInputStreamClass *class;
492 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), FALSE);
494 class = G_INPUT_STREAM_GET_CLASS (stream);
496 if (stream->priv->closed)
501 if (!g_input_stream_set_pending (stream, error))
505 g_cancellable_push_current (cancellable);
508 res = class->close_fn (stream, cancellable, error);
511 g_cancellable_pop_current (cancellable);
513 g_input_stream_clear_pending (stream);
515 stream->priv->closed = TRUE;
521 async_ready_callback_wrapper (GObject *source_object,
525 GInputStream *stream = G_INPUT_STREAM (source_object);
527 g_input_stream_clear_pending (stream);
528 if (stream->priv->outstanding_callback)
529 (*stream->priv->outstanding_callback) (source_object, res, user_data);
530 g_object_unref (stream);
534 async_ready_close_callback_wrapper (GObject *source_object,
538 GInputStream *stream = G_INPUT_STREAM (source_object);
540 g_input_stream_clear_pending (stream);
541 stream->priv->closed = TRUE;
542 if (stream->priv->outstanding_callback)
543 (*stream->priv->outstanding_callback) (source_object, res, user_data);
544 g_object_unref (stream);
548 * g_input_stream_read_async:
549 * @stream: A #GInputStream.
550 * @buffer: a buffer to read data into (which should be at least count bytes long).
551 * @count: the number of bytes that will be read from the stream
552 * @io_priority: the <link linkend="io-priority">I/O priority</link>
554 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
555 * @callback: (scope async): callback to call when the request is satisfied
556 * @user_data: (closure): the data to pass to callback function
558 * Request an asynchronous read of @count bytes from the stream into the buffer
559 * starting at @buffer. When the operation is finished @callback will be called.
560 * You can then call g_input_stream_read_finish() to get the result of the
563 * During an async request no other sync and async calls are allowed on @stream, and will
564 * result in %G_IO_ERROR_PENDING errors.
566 * A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
568 * On success, the number of bytes read into the buffer will be passed to the
569 * callback. It is not an error if this is not the same as the requested size, as it
570 * can happen e.g. near the end of a file, but generally we try to read
571 * as many bytes as requested. Zero is returned on end of file
572 * (or if @count is zero), but never otherwise.
574 * Any outstanding i/o request with higher priority (lower numerical value) will
575 * be executed before an outstanding request with lower priority. Default
576 * priority is %G_PRIORITY_DEFAULT.
578 * The asyncronous methods have a default fallback that uses threads to implement
579 * asynchronicity, so they are optional for inheriting classes. However, if you
580 * override one you must override all.
583 g_input_stream_read_async (GInputStream *stream,
587 GCancellable *cancellable,
588 GAsyncReadyCallback callback,
591 GInputStreamClass *class;
592 GSimpleAsyncResult *simple;
593 GError *error = NULL;
595 g_return_if_fail (G_IS_INPUT_STREAM (stream));
596 g_return_if_fail (buffer != NULL);
600 simple = g_simple_async_result_new (G_OBJECT (stream),
603 g_input_stream_read_async);
604 g_simple_async_result_complete_in_idle (simple);
605 g_object_unref (simple);
609 if (((gssize) count) < 0)
611 g_simple_async_report_error_in_idle (G_OBJECT (stream),
614 G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
615 _("Too large count value passed to %s"),
620 if (!g_input_stream_set_pending (stream, &error))
622 g_simple_async_report_take_gerror_in_idle (G_OBJECT (stream),
629 class = G_INPUT_STREAM_GET_CLASS (stream);
630 stream->priv->outstanding_callback = callback;
631 g_object_ref (stream);
632 class->read_async (stream, buffer, count, io_priority, cancellable,
633 async_ready_callback_wrapper, user_data);
637 * g_input_stream_read_finish:
638 * @stream: a #GInputStream.
639 * @result: a #GAsyncResult.
640 * @error: a #GError location to store the error occurring, or %NULL to
643 * Finishes an asynchronous stream read operation.
645 * Returns: number of bytes read in, or -1 on error, or 0 on end of file.
648 g_input_stream_read_finish (GInputStream *stream,
649 GAsyncResult *result,
652 GSimpleAsyncResult *simple;
653 GInputStreamClass *class;
655 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), -1);
656 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), -1);
658 if (g_async_result_legacy_propagate_error (result, error))
661 if (G_IS_SIMPLE_ASYNC_RESULT (result))
663 simple = G_SIMPLE_ASYNC_RESULT (result);
665 /* Special case read of 0 bytes */
666 if (g_simple_async_result_get_source_tag (simple) == g_input_stream_read_async)
670 class = G_INPUT_STREAM_GET_CLASS (stream);
671 return class->read_finish (stream, result, error);
675 read_bytes_callback (GObject *stream,
676 GAsyncResult *result,
679 GSimpleAsyncResult *simple = user_data;
680 guchar *buf = g_simple_async_result_get_op_res_gpointer (simple);
681 GError *error = NULL;
683 GBytes *bytes = NULL;
685 nread = g_input_stream_read_finish (G_INPUT_STREAM (stream),
690 g_simple_async_result_take_error (simple, error);
695 bytes = g_bytes_new_static ("", 0);
698 bytes = g_bytes_new_take (buf, nread);
702 g_simple_async_result_set_op_res_gpointer (simple, bytes,
703 (GDestroyNotify)g_bytes_unref);
705 g_simple_async_result_complete (simple);
706 g_object_unref (simple);
710 * g_input_stream_read_bytes_async:
711 * @stream: A #GInputStream.
712 * @count: the number of bytes that will be read from the stream
713 * @io_priority: the <link linkend="io-priority">I/O priority</link>
715 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
716 * @callback: (scope async): callback to call when the request is satisfied
717 * @user_data: (closure): the data to pass to callback function
719 * Request an asynchronous read of @count bytes from the stream into a
720 * new #GBytes. When the operation is finished @callback will be
721 * called. You can then call g_input_stream_read_bytes_finish() to get the
722 * result of the operation.
724 * During an async request no other sync and async calls are allowed
725 * on @stream, and will result in %G_IO_ERROR_PENDING errors.
727 * A value of @count larger than %G_MAXSSIZE will cause a
728 * %G_IO_ERROR_INVALID_ARGUMENT error.
730 * On success, the new #GBytes will be passed to the callback. It is
731 * not an error if this is smaller than the requested size, as it can
732 * happen e.g. near the end of a file, but generally we try to read as
733 * many bytes as requested. Zero is returned on end of file (or if
734 * @count is zero), but never otherwise.
736 * Any outstanding I/O request with higher priority (lower numerical
737 * value) will be executed before an outstanding request with lower
738 * priority. Default priority is %G_PRIORITY_DEFAULT.
741 g_input_stream_read_bytes_async (GInputStream *stream,
744 GCancellable *cancellable,
745 GAsyncReadyCallback callback,
748 GSimpleAsyncResult *simple;
751 simple = g_simple_async_result_new (G_OBJECT (stream),
753 g_input_stream_read_bytes_async);
754 buf = g_malloc (count);
755 g_simple_async_result_set_op_res_gpointer (simple, buf, NULL);
757 g_input_stream_read_async (stream, buf, count,
758 io_priority, cancellable,
759 read_bytes_callback, simple);
763 * g_input_stream_read_bytes_finish:
764 * @stream: a #GInputStream.
765 * @result: a #GAsyncResult.
766 * @error: a #GError location to store the error occurring, or %NULL to
769 * Finishes an asynchronous stream read-into-#GBytes operation.
771 * Returns: the newly-allocated #GBytes, or %NULL on error
774 g_input_stream_read_bytes_finish (GInputStream *stream,
775 GAsyncResult *result,
778 GSimpleAsyncResult *simple;
780 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), NULL);
781 g_return_val_if_fail (g_simple_async_result_is_valid (result, G_OBJECT (stream), g_input_stream_read_bytes_async), NULL);
783 simple = G_SIMPLE_ASYNC_RESULT (result);
784 if (g_simple_async_result_propagate_error (simple, error))
786 return g_bytes_ref (g_simple_async_result_get_op_res_gpointer (simple));
790 * g_input_stream_skip_async:
791 * @stream: A #GInputStream.
792 * @count: the number of bytes that will be skipped from the stream
793 * @io_priority: the <link linkend="io-priority">I/O priority</link>
795 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
796 * @callback: (scope async): callback to call when the request is satisfied
797 * @user_data: (closure): the data to pass to callback function
799 * Request an asynchronous skip of @count bytes from the stream.
800 * When the operation is finished @callback will be called.
801 * You can then call g_input_stream_skip_finish() to get the result
804 * During an async request no other sync and async calls are allowed,
805 * and will result in %G_IO_ERROR_PENDING errors.
807 * A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
809 * On success, the number of bytes skipped will be passed to the callback.
810 * It is not an error if this is not the same as the requested size, as it
811 * can happen e.g. near the end of a file, but generally we try to skip
812 * as many bytes as requested. Zero is returned on end of file
813 * (or if @count is zero), but never otherwise.
815 * Any outstanding i/o request with higher priority (lower numerical value)
816 * will be executed before an outstanding request with lower priority.
817 * Default priority is %G_PRIORITY_DEFAULT.
819 * The asynchronous methods have a default fallback that uses threads to
820 * implement asynchronicity, so they are optional for inheriting classes.
821 * However, if you override one, you must override all.
824 g_input_stream_skip_async (GInputStream *stream,
827 GCancellable *cancellable,
828 GAsyncReadyCallback callback,
831 GInputStreamClass *class;
832 GSimpleAsyncResult *simple;
833 GError *error = NULL;
835 g_return_if_fail (G_IS_INPUT_STREAM (stream));
839 simple = g_simple_async_result_new (G_OBJECT (stream),
842 g_input_stream_skip_async);
844 g_simple_async_result_complete_in_idle (simple);
845 g_object_unref (simple);
849 if (((gssize) count) < 0)
851 g_simple_async_report_error_in_idle (G_OBJECT (stream),
854 G_IO_ERROR, G_IO_ERROR_INVALID_ARGUMENT,
855 _("Too large count value passed to %s"),
860 if (!g_input_stream_set_pending (stream, &error))
862 g_simple_async_report_take_gerror_in_idle (G_OBJECT (stream),
869 class = G_INPUT_STREAM_GET_CLASS (stream);
870 stream->priv->outstanding_callback = callback;
871 g_object_ref (stream);
872 class->skip_async (stream, count, io_priority, cancellable,
873 async_ready_callback_wrapper, user_data);
877 * g_input_stream_skip_finish:
878 * @stream: a #GInputStream.
879 * @result: a #GAsyncResult.
880 * @error: a #GError location to store the error occurring, or %NULL to
883 * Finishes a stream skip operation.
885 * Returns: the size of the bytes skipped, or %-1 on error.
888 g_input_stream_skip_finish (GInputStream *stream,
889 GAsyncResult *result,
892 GSimpleAsyncResult *simple;
893 GInputStreamClass *class;
895 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), -1);
896 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), -1);
898 if (g_async_result_legacy_propagate_error (result, error))
901 if (G_IS_SIMPLE_ASYNC_RESULT (result))
903 simple = G_SIMPLE_ASYNC_RESULT (result);
905 /* Special case skip of 0 bytes */
906 if (g_simple_async_result_get_source_tag (simple) == g_input_stream_skip_async)
910 class = G_INPUT_STREAM_GET_CLASS (stream);
911 return class->skip_finish (stream, result, error);
915 * g_input_stream_close_async:
916 * @stream: A #GInputStream.
917 * @io_priority: the <link linkend="io-priority">I/O priority</link>
919 * @cancellable: (allow-none): optional cancellable object
920 * @callback: (scope async): callback to call when the request is satisfied
921 * @user_data: (closure): the data to pass to callback function
923 * Requests an asynchronous closes of the stream, releasing resources related to it.
924 * When the operation is finished @callback will be called.
925 * You can then call g_input_stream_close_finish() to get the result of the
928 * For behaviour details see g_input_stream_close().
930 * The asyncronous methods have a default fallback that uses threads to implement
931 * asynchronicity, so they are optional for inheriting classes. However, if you
932 * override one you must override all.
935 g_input_stream_close_async (GInputStream *stream,
937 GCancellable *cancellable,
938 GAsyncReadyCallback callback,
941 GInputStreamClass *class;
942 GSimpleAsyncResult *simple;
943 GError *error = NULL;
945 g_return_if_fail (G_IS_INPUT_STREAM (stream));
947 if (stream->priv->closed)
949 simple = g_simple_async_result_new (G_OBJECT (stream),
952 g_input_stream_close_async);
954 g_simple_async_result_complete_in_idle (simple);
955 g_object_unref (simple);
959 if (!g_input_stream_set_pending (stream, &error))
961 g_simple_async_report_take_gerror_in_idle (G_OBJECT (stream),
968 class = G_INPUT_STREAM_GET_CLASS (stream);
969 stream->priv->outstanding_callback = callback;
970 g_object_ref (stream);
971 class->close_async (stream, io_priority, cancellable,
972 async_ready_close_callback_wrapper, user_data);
976 * g_input_stream_close_finish:
977 * @stream: a #GInputStream.
978 * @result: a #GAsyncResult.
979 * @error: a #GError location to store the error occurring, or %NULL to
982 * Finishes closing a stream asynchronously, started from g_input_stream_close_async().
984 * Returns: %TRUE if the stream was closed successfully.
987 g_input_stream_close_finish (GInputStream *stream,
988 GAsyncResult *result,
991 GSimpleAsyncResult *simple;
992 GInputStreamClass *class;
994 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), FALSE);
995 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
997 if (g_async_result_legacy_propagate_error (result, error))
1000 if (G_IS_SIMPLE_ASYNC_RESULT (result))
1002 simple = G_SIMPLE_ASYNC_RESULT (result);
1004 /* Special case already closed */
1005 if (g_simple_async_result_get_source_tag (simple) == g_input_stream_close_async)
1009 class = G_INPUT_STREAM_GET_CLASS (stream);
1010 return class->close_finish (stream, result, error);
1014 * g_input_stream_is_closed:
1015 * @stream: input stream.
1017 * Checks if an input stream is closed.
1019 * Returns: %TRUE if the stream is closed.
1022 g_input_stream_is_closed (GInputStream *stream)
1024 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), TRUE);
1026 return stream->priv->closed;
1030 * g_input_stream_has_pending:
1031 * @stream: input stream.
1033 * Checks if an input stream has pending actions.
1035 * Returns: %TRUE if @stream has pending actions.
1038 g_input_stream_has_pending (GInputStream *stream)
1040 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), TRUE);
1042 return stream->priv->pending;
1046 * g_input_stream_set_pending:
1047 * @stream: input stream
1048 * @error: a #GError location to store the error occurring, or %NULL to
1051 * Sets @stream to have actions pending. If the pending flag is
1052 * already set or @stream is closed, it will return %FALSE and set
1055 * Return value: %TRUE if pending was previously unset and is now set.
1058 g_input_stream_set_pending (GInputStream *stream, GError **error)
1060 g_return_val_if_fail (G_IS_INPUT_STREAM (stream), FALSE);
1062 if (stream->priv->closed)
1064 g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_CLOSED,
1065 _("Stream is already closed"));
1069 if (stream->priv->pending)
1071 g_set_error_literal (error, G_IO_ERROR, G_IO_ERROR_PENDING,
1072 /* Translators: This is an error you get if there is already an
1073 * operation running against this stream when you try to start
1075 _("Stream has outstanding operation"));
1079 stream->priv->pending = TRUE;
1084 * g_input_stream_clear_pending:
1085 * @stream: input stream
1087 * Clears the pending flag on @stream.
1090 g_input_stream_clear_pending (GInputStream *stream)
1092 g_return_if_fail (G_IS_INPUT_STREAM (stream));
1094 stream->priv->pending = FALSE;
1097 /********************************************
1098 * Default implementation of async ops *
1099 ********************************************/
1103 gsize count_requested;
1106 GCancellable *cancellable;
1112 free_read_data (ReadData *op)
1114 if (op->cancellable)
1115 g_object_unref (op->cancellable);
1116 g_slice_free (ReadData, op);
1120 read_async_thread (GSimpleAsyncResult *res,
1122 GCancellable *cancellable)
1125 GInputStreamClass *class;
1126 GError *error = NULL;
1128 op = g_simple_async_result_get_op_res_gpointer (res);
1130 class = G_INPUT_STREAM_GET_CLASS (object);
1132 op->count_read = class->read_fn (G_INPUT_STREAM (object),
1133 op->buffer, op->count_requested,
1134 cancellable, &error);
1135 if (op->count_read == -1)
1136 g_simple_async_result_take_error (res, error);
1139 static void read_async_pollable (GPollableInputStream *stream,
1140 GSimpleAsyncResult *result);
1143 read_async_pollable_ready (GPollableInputStream *stream,
1146 GSimpleAsyncResult *result = user_data;
1148 read_async_pollable (stream, result);
1153 read_async_pollable (GPollableInputStream *stream,
1154 GSimpleAsyncResult *result)
1156 GError *error = NULL;
1157 ReadData *op = g_simple_async_result_get_op_res_gpointer (result);
1159 if (g_cancellable_set_error_if_cancelled (op->cancellable, &error))
1160 op->count_read = -1;
1163 op->count_read = G_POLLABLE_INPUT_STREAM_GET_INTERFACE (stream)->
1164 read_nonblocking (stream, op->buffer, op->count_requested, &error);
1167 if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_WOULD_BLOCK))
1171 g_error_free (error);
1172 op->need_idle = FALSE;
1174 source = g_pollable_input_stream_create_source (stream, op->cancellable);
1175 g_source_set_callback (source,
1176 (GSourceFunc) read_async_pollable_ready,
1177 g_object_ref (result), g_object_unref);
1178 g_source_set_priority (source, op->io_priority);
1179 g_source_attach (source, g_main_context_get_thread_default ());
1180 g_source_unref (source);
1184 if (op->count_read == -1)
1185 g_simple_async_result_take_error (result, error);
1188 g_simple_async_result_complete_in_idle (result);
1190 g_simple_async_result_complete (result);
1194 g_input_stream_real_read_async (GInputStream *stream,
1198 GCancellable *cancellable,
1199 GAsyncReadyCallback callback,
1202 GSimpleAsyncResult *res;
1205 op = g_slice_new0 (ReadData);
1206 res = g_simple_async_result_new (G_OBJECT (stream), callback, user_data, g_input_stream_real_read_async);
1207 g_simple_async_result_set_op_res_gpointer (res, op, (GDestroyNotify) free_read_data);
1208 op->buffer = buffer;
1209 op->count_requested = count;
1210 op->cancellable = cancellable ? g_object_ref (cancellable) : NULL;
1211 op->io_priority = io_priority;
1212 op->need_idle = TRUE;
1214 if (G_IS_POLLABLE_INPUT_STREAM (stream) &&
1215 g_pollable_input_stream_can_poll (G_POLLABLE_INPUT_STREAM (stream)))
1216 read_async_pollable (G_POLLABLE_INPUT_STREAM (stream), res);
1218 g_simple_async_result_run_in_thread (res, read_async_thread, io_priority, cancellable);
1219 g_object_unref (res);
1223 g_input_stream_real_read_finish (GInputStream *stream,
1224 GAsyncResult *result,
1227 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
1230 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) ==
1231 g_input_stream_real_read_async);
1233 if (g_simple_async_result_propagate_error (simple, error))
1236 op = g_simple_async_result_get_op_res_gpointer (simple);
1238 return op->count_read;
1242 gsize count_requested;
1243 gssize count_skipped;
1248 skip_async_thread (GSimpleAsyncResult *res,
1250 GCancellable *cancellable)
1253 GInputStreamClass *class;
1254 GError *error = NULL;
1256 class = G_INPUT_STREAM_GET_CLASS (object);
1257 op = g_simple_async_result_get_op_res_gpointer (res);
1258 op->count_skipped = class->skip (G_INPUT_STREAM (object),
1259 op->count_requested,
1260 cancellable, &error);
1261 if (op->count_skipped == -1)
1262 g_simple_async_result_take_error (res, error);
1268 gsize count_skipped;
1270 GCancellable *cancellable;
1272 GAsyncReadyCallback callback;
1273 } SkipFallbackAsyncData;
1276 skip_callback_wrapper (GObject *source_object,
1280 GInputStreamClass *class;
1281 SkipFallbackAsyncData *data = user_data;
1283 GSimpleAsyncResult *simple;
1284 GError *error = NULL;
1287 ret = g_input_stream_read_finish (G_INPUT_STREAM (source_object), res, &error);
1292 data->count_skipped += ret;
1294 if (data->count > 0)
1296 class = G_INPUT_STREAM_GET_CLASS (source_object);
1297 class->read_async (G_INPUT_STREAM (source_object), data->buffer, MIN (8192, data->count), data->io_prio, data->cancellable,
1298 skip_callback_wrapper, data);
1303 op = g_new0 (SkipData, 1);
1304 op->count_skipped = data->count_skipped;
1305 simple = g_simple_async_result_new (source_object,
1306 data->callback, data->user_data,
1307 g_input_stream_real_skip_async);
1309 g_simple_async_result_set_op_res_gpointer (simple, op, g_free);
1313 if (data->count_skipped &&
1314 g_error_matches (error, G_IO_ERROR, G_IO_ERROR_CANCELLED))
1315 /* No error, return partial read */
1316 g_error_free (error);
1318 g_simple_async_result_take_error (simple, error);
1321 /* Complete immediately, not in idle, since we're already in a mainloop callout */
1322 g_simple_async_result_complete (simple);
1323 g_object_unref (simple);
1329 g_input_stream_real_skip_async (GInputStream *stream,
1332 GCancellable *cancellable,
1333 GAsyncReadyCallback callback,
1336 GInputStreamClass *class;
1338 SkipFallbackAsyncData *data;
1339 GSimpleAsyncResult *res;
1341 class = G_INPUT_STREAM_GET_CLASS (stream);
1343 if (class->read_async == g_input_stream_real_read_async)
1345 /* Read is thread-using async fallback.
1346 * Make skip use threads too, so that we can use a possible sync skip
1347 * implementation. */
1348 op = g_new0 (SkipData, 1);
1350 res = g_simple_async_result_new (G_OBJECT (stream), callback, user_data,
1351 g_input_stream_real_skip_async);
1353 g_simple_async_result_set_op_res_gpointer (res, op, g_free);
1355 op->count_requested = count;
1357 g_simple_async_result_run_in_thread (res, skip_async_thread, io_priority, cancellable);
1358 g_object_unref (res);
1362 /* TODO: Skip fallback uses too much memory, should do multiple read calls */
1364 /* There is a custom async read function, lets use that. */
1365 data = g_new (SkipFallbackAsyncData, 1);
1366 data->count = count;
1367 data->count_skipped = 0;
1368 data->io_prio = io_priority;
1369 data->cancellable = cancellable;
1370 data->callback = callback;
1371 data->user_data = user_data;
1372 class->read_async (stream, data->buffer, MIN (8192, count), io_priority, cancellable,
1373 skip_callback_wrapper, data);
1379 g_input_stream_real_skip_finish (GInputStream *stream,
1380 GAsyncResult *result,
1383 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
1386 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) == g_input_stream_real_skip_async);
1388 if (g_simple_async_result_propagate_error (simple, error))
1391 op = g_simple_async_result_get_op_res_gpointer (simple);
1392 return op->count_skipped;
1396 close_async_thread (GSimpleAsyncResult *res,
1398 GCancellable *cancellable)
1400 GInputStreamClass *class;
1401 GError *error = NULL;
1404 /* Auto handling of cancelation disabled, and ignore
1405 cancellation, since we want to close things anyway, although
1406 possibly in a quick-n-dirty way. At least we never want to leak
1409 class = G_INPUT_STREAM_GET_CLASS (object);
1410 if (class->close_fn)
1412 result = class->close_fn (G_INPUT_STREAM (object), cancellable, &error);
1414 g_simple_async_result_take_error (res, error);
1419 g_input_stream_real_close_async (GInputStream *stream,
1421 GCancellable *cancellable,
1422 GAsyncReadyCallback callback,
1425 GSimpleAsyncResult *res;
1427 res = g_simple_async_result_new (G_OBJECT (stream),
1430 g_input_stream_real_close_async);
1432 g_simple_async_result_set_handle_cancellation (res, FALSE);
1434 g_simple_async_result_run_in_thread (res,
1438 g_object_unref (res);
1442 g_input_stream_real_close_finish (GInputStream *stream,
1443 GAsyncResult *result,
1446 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
1448 g_warn_if_fail (g_simple_async_result_get_source_tag (simple) == g_input_stream_real_close_async);
1450 if (g_simple_async_result_propagate_error (simple, error))