## 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