GDataOutputStream

GDataOutputStream — Data Output Stream

Synopsis


#include <gio/gio.h>


                    GDataOutputStream;
GDataOutputStream*  g_data_output_stream_new            (GOutputStream *base_stream);
void                g_data_output_stream_set_byte_order (GDataOutputStream *stream,
                                                         GDataStreamByteOrder order);
GDataStreamByteOrder g_data_output_stream_get_byte_order
                                                        (GDataOutputStream *stream);
gboolean            g_data_output_stream_put_byte       (GDataOutputStream *stream,
                                                         guchar data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_int16      (GDataOutputStream *stream,
                                                         gint16 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_uint16     (GDataOutputStream *stream,
                                                         guint16 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_int32      (GDataOutputStream *stream,
                                                         gint32 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_uint32     (GDataOutputStream *stream,
                                                         guint32 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_int64      (GDataOutputStream *stream,
                                                         gint64 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_uint64     (GDataOutputStream *stream,
                                                         guint64 data,
                                                         GCancellable *cancellable,
                                                         GError **error);
gboolean            g_data_output_stream_put_string     (GDataOutputStream *stream,
                                                         const char *str,
                                                         GCancellable *cancellable,
                                                         GError **error);

Object Hierarchy


  GObject
   +----GOutputStream
         +----GFilterOutputStream
               +----GDataOutputStream

Properties


  "byte-order"               GDataStreamByteOrder  : Read / Write

Description

Data output stream implements GOutputStream and includes functions for writing data directly to an output stream.

Details

GDataOutputStream

typedef struct _GDataOutputStream GDataOutputStream;

An implementation of GBufferedOutputStream that allows for high-level data manipulation of arbitrary data (including binary operations).

g_data_output_stream_new ()

GDataOutputStream*  g_data_output_stream_new            (GOutputStream *base_stream);

Creates a new data output stream for base_stream.

base_stream : a GOutputStream.
Returns : GDataOutputStream.

g_data_output_stream_set_byte_order ()

void                g_data_output_stream_set_byte_order (GDataOutputStream *stream,
                                                         GDataStreamByteOrder order);

Sets the byte order of the data output stream to order.

stream : a GDataOutputStream.
order : a GDataStreamByteOrder.

g_data_output_stream_get_byte_order ()

GDataStreamByteOrder g_data_output_stream_get_byte_order
                                                        (GDataOutputStream *stream);

Gets the byte order for the stream.

stream : a GDataOutputStream.
Returns : the GDataStreamByteOrder for the stream.

g_data_output_stream_put_byte ()

gboolean            g_data_output_stream_put_byte       (GDataOutputStream *stream,
                                                         guchar data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts a byte into the output stream.

stream : a GDataOutputStream.
data : a guchar.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_int16 ()

gboolean            g_data_output_stream_put_int16      (GDataOutputStream *stream,
                                                         gint16 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts a signed 16-bit integer into the output stream.

stream : a GDataOutputStream.
data : a gint16.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_uint16 ()

gboolean            g_data_output_stream_put_uint16     (GDataOutputStream *stream,
                                                         guint16 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts an unsigned 16-bit integer into the output stream.

stream : a GDataOutputStream.
data : a guint16.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_int32 ()

gboolean            g_data_output_stream_put_int32      (GDataOutputStream *stream,
                                                         gint32 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts a signed 32-bit integer into the output stream.

stream : a GDataOutputStream.
data : a gint32.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_uint32 ()

gboolean            g_data_output_stream_put_uint32     (GDataOutputStream *stream,
                                                         guint32 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts an unsigned 32-bit integer into the stream.

stream : a GDataOutputStream.
data : a guint32.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_int64 ()

gboolean            g_data_output_stream_put_int64      (GDataOutputStream *stream,
                                                         gint64 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts a signed 64-bit integer into the stream.

stream : a GDataOutputStream.
data : a gint64.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_uint64 ()

gboolean            g_data_output_stream_put_uint64     (GDataOutputStream *stream,
                                                         guint64 data,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts an unsigned 64-bit integer into the stream.

stream : a GDataOutputStream.
data : a guint64.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if data was successfully added to the stream.

g_data_output_stream_put_string ()

gboolean            g_data_output_stream_put_string     (GDataOutputStream *stream,
                                                         const char *str,
                                                         GCancellable *cancellable,
                                                         GError **error);

Puts a string into the output stream.

stream : a GDataOutputStream.
str : a string.
cancellable : optional GCancellable object, NULL to ignore.
error : a GError, NULL to ignore.
Returns : TRUE if string was successfully added to the stream.

Property Details

The "byte-order" property

  "byte-order"               GDataStreamByteOrder  : Read / Write

Determines the byte ordering that is used when writing multi-byte entities (such as integers) to the stream.

Default value: G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN

See Also

GOutputStream