GApplication: Plug a memory leak
[platform/upstream/glib.git] / gio / ginputstream.h
index c6ec443..a9c269c 100644 (file)
@@ -1,5 +1,5 @@
 /* GIO - GLib Input, Output and Streaming Library
- * 
+ *
  * Copyright (C) 2006-2007 Red Hat, Inc.
  *
  * This library is free software; you can redistribute it and/or
@@ -13,9 +13,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General
- * Public License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
  *
  * Author: Alexander Larsson <alexl@redhat.com>
  */
 #ifndef __G_INPUT_STREAM_H__
 #define __G_INPUT_STREAM_H__
 
-#include <glib-object.h>
-#include <gio/gioerror.h>
-#include <gio/gcancellable.h>
-#include <gio/gasyncresult.h>
+#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
+#error "Only <gio/gio.h> can be included directly."
+#endif
+
+#include <gio/giotypes.h>
 
 G_BEGIN_DECLS
 
@@ -39,16 +38,15 @@ G_BEGIN_DECLS
 
 /**
  * GInputStream:
- * 
+ *
  * Base class for streaming input operations.
  **/
-typedef struct _GInputStream         GInputStream;
 typedef struct _GInputStreamClass    GInputStreamClass;
 typedef struct _GInputStreamPrivate  GInputStreamPrivate;
 
 struct _GInputStream
 {
-  GObject parent;
+  GObject parent_instance;
 
   /*< private >*/
   GInputStreamPrivate *priv;
@@ -59,48 +57,48 @@ struct _GInputStreamClass
   GObjectClass parent_class;
 
   /* Sync ops: */
-  
-  gssize   (* read)        (GInputStream *stream,
-                           void         *buffer,
-                           gsize         count,
-                           GCancellable *cancellable,
-                           GError      **error);
-  gssize   (* skip)        (GInputStream *stream,
-                           gsize         count,
-                           GCancellable *cancellable,
-                           GError      **error);
-  gboolean (* close)      (GInputStream *stream,
-                           GCancellable *cancellable,
-                           GError      **error);
+
+  gssize   (* read_fn)      (GInputStream        *stream,
+                             void                *buffer,
+                             gsize                count,
+                             GCancellable        *cancellable,
+                             GError             **error);
+  gssize   (* skip)         (GInputStream        *stream,
+                             gsize                count,
+                             GCancellable        *cancellable,
+                             GError             **error);
+  gboolean (* close_fn)            (GInputStream        *stream,
+                             GCancellable        *cancellable,
+                             GError             **error);
 
   /* Async ops: (optional in derived classes) */
-  void     (* read_async)  (GInputStream        *stream,
-                           void               *buffer,
-                           gsize               count,
-                           int                 io_priority,
-                           GCancellable       *cancellable,
-                           GAsyncReadyCallback callback,
-                           gpointer            user_data);
-  gssize   (* read_finish) (GInputStream       *stream,
-                           GAsyncResult       *result,
-                           GError            **error);
-  void     (* skip_async)  (GInputStream       *stream,
-                           gsize               count,
-                           int                 io_priority,
-                           GCancellable       *cancellable,
-                           GAsyncReadyCallback callback,
-                           gpointer            user_data);
-  gssize   (* skip_finish) (GInputStream        *stream,
-                           GAsyncResult       *result,
-                           GError            **error);
-  void     (* close_async) (GInputStream        *stream,
-                           int                  io_priority,
-                           GCancellable       *cancellable,
-                           GAsyncReadyCallback callback,
-                           gpointer            user_data);
-  gboolean (* close_finish)(GInputStream        *stream,
-                           GAsyncResult       *result,
-                           GError            **error);
+  void     (* read_async)   (GInputStream        *stream,
+                             void                *buffer,
+                             gsize                count,
+                             int                  io_priority,
+                             GCancellable        *cancellable,
+                             GAsyncReadyCallback  callback,
+                             gpointer             user_data);
+  gssize   (* read_finish)  (GInputStream        *stream,
+                             GAsyncResult        *result,
+                             GError             **error);
+  void     (* skip_async)   (GInputStream        *stream,
+                             gsize                count,
+                             int                  io_priority,
+                             GCancellable        *cancellable,
+                             GAsyncReadyCallback  callback,
+                             gpointer             user_data);
+  gssize   (* skip_finish)  (GInputStream        *stream,
+                             GAsyncResult        *result,
+                             GError             **error);
+  void     (* close_async)  (GInputStream        *stream,
+                             int                  io_priority,
+                             GCancellable        *cancellable,
+                             GAsyncReadyCallback  callback,
+                             gpointer             user_data);
+  gboolean (* close_finish) (GInputStream        *stream,
+                             GAsyncResult        *result,
+                             GError             **error);
 
   /*< private >*/
   /* Padding for future expansion */
@@ -111,60 +109,92 @@ struct _GInputStreamClass
   void (*_g_reserved5) (void);
 };
 
-GType g_input_stream_get_type (void) G_GNUC_CONST;
-
-gssize   g_input_stream_read         (GInputStream          *stream,
-                                     void                  *buffer,
-                                     gsize                  count,
-                                     GCancellable          *cancellable,
-                                     GError               **error);
-gboolean g_input_stream_read_all     (GInputStream          *stream,
-                                     void                  *buffer,
-                                     gsize                  count,
-                                     gsize                 *bytes_read,
-                                     GCancellable          *cancellable,
-                                     GError               **error);
-gssize   g_input_stream_skip         (GInputStream          *stream,
-                                     gsize                  count,
-                                     GCancellable          *cancellable,
-                                     GError               **error);
-gboolean g_input_stream_close        (GInputStream          *stream,
-                                     GCancellable          *cancellable,
-                                     GError               **error);
-void     g_input_stream_read_async   (GInputStream          *stream,
-                                     void                  *buffer,
-                                     gsize                  count,
-                                     int                    io_priority,
-                                     GCancellable          *cancellable,
-                                     GAsyncReadyCallback    callback,
-                                     gpointer               user_data);
-gssize   g_input_stream_read_finish  (GInputStream          *stream,
-                                     GAsyncResult          *result,
-                                     GError               **error);
-void     g_input_stream_skip_async   (GInputStream          *stream,
-                                     gsize                  count,
-                                     int                    io_priority,
-                                     GCancellable          *cancellable,
-                                     GAsyncReadyCallback    callback,
-                                     gpointer               user_data);
-gssize   g_input_stream_skip_finish  (GInputStream          *stream,
-                                     GAsyncResult          *result,
-                                     GError               **error);
-void     g_input_stream_close_async  (GInputStream          *stream,
-                                     int                    io_priority,
-                                     GCancellable          *cancellable,
-                                     GAsyncReadyCallback    callback,
-                                     gpointer               user_data);
-gboolean g_input_stream_close_finish (GInputStream          *stream,
-                                     GAsyncResult          *result,
-                                     GError               **error);
+GLIB_AVAILABLE_IN_ALL
+GType    g_input_stream_get_type      (void) G_GNUC_CONST;
+
+GLIB_AVAILABLE_IN_ALL
+gssize   g_input_stream_read          (GInputStream          *stream,
+                                      void                  *buffer,
+                                      gsize                  count,
+                                      GCancellable          *cancellable,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_read_all      (GInputStream          *stream,
+                                      void                  *buffer,
+                                      gsize                  count,
+                                      gsize                 *bytes_read,
+                                      GCancellable          *cancellable,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_2_34
+GBytes  *g_input_stream_read_bytes    (GInputStream          *stream,
+                                      gsize                  count,
+                                      GCancellable          *cancellable,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+gssize   g_input_stream_skip          (GInputStream          *stream,
+                                      gsize                  count,
+                                      GCancellable          *cancellable,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_close         (GInputStream          *stream,
+                                      GCancellable          *cancellable,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+void     g_input_stream_read_async    (GInputStream          *stream,
+                                      void                  *buffer,
+                                      gsize                  count,
+                                      int                    io_priority,
+                                      GCancellable          *cancellable,
+                                      GAsyncReadyCallback    callback,
+                                      gpointer               user_data);
+GLIB_AVAILABLE_IN_ALL
+gssize   g_input_stream_read_finish   (GInputStream          *stream,
+                                      GAsyncResult          *result,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_2_34
+void     g_input_stream_read_bytes_async  (GInputStream          *stream,
+                                          gsize                  count,
+                                          int                    io_priority,
+                                          GCancellable          *cancellable,
+                                          GAsyncReadyCallback    callback,
+                                          gpointer               user_data);
+GLIB_AVAILABLE_IN_2_34
+GBytes  *g_input_stream_read_bytes_finish (GInputStream          *stream,
+                                          GAsyncResult          *result,
+                                          GError               **error);
+GLIB_AVAILABLE_IN_ALL
+void     g_input_stream_skip_async    (GInputStream          *stream,
+                                      gsize                  count,
+                                      int                    io_priority,
+                                      GCancellable          *cancellable,
+                                      GAsyncReadyCallback    callback,
+                                      gpointer               user_data);
+GLIB_AVAILABLE_IN_ALL
+gssize   g_input_stream_skip_finish   (GInputStream          *stream,
+                                      GAsyncResult          *result,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+void     g_input_stream_close_async   (GInputStream          *stream,
+                                      int                    io_priority,
+                                      GCancellable          *cancellable,
+                                      GAsyncReadyCallback    callback,
+                                      gpointer               user_data);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_close_finish  (GInputStream          *stream,
+                                      GAsyncResult          *result,
+                                      GError               **error);
 
 /* For implementations: */
 
-gboolean g_input_stream_is_closed    (GInputStream          *stream);
-gboolean g_input_stream_has_pending  (GInputStream          *stream);
-void     g_input_stream_set_pending  (GInputStream          *stream,
-                                     gboolean               pending);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_is_closed     (GInputStream          *stream);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_has_pending   (GInputStream          *stream);
+GLIB_AVAILABLE_IN_ALL
+gboolean g_input_stream_set_pending   (GInputStream          *stream,
+                                      GError               **error);
+GLIB_AVAILABLE_IN_ALL
+void     g_input_stream_clear_pending (GInputStream          *stream);
 
 G_END_DECLS