Method

GioOutputStreamwrite_bytes

Declaration

gssize
g_output_stream_write_bytes (
  GOutputStream* stream,
  GBytes* bytes,
  GCancellable* cancellable,
  GError** error
)

Description

A wrapper function for g_output_stream_write() which takes a GBytes as input. This can be more convenient for use by language bindings or in other cases where the refcounted nature of GBytes is helpful over a bare pointer interface.

However, note that this function may still perform partial writes, just like g_output_stream_write(). If that occurs, to continue writing, you will need to create a new GBytes containing just the remaining bytes, using g_bytes_new_from_bytes(). Passing the same GBytes instance multiple times potentially can result in duplicated data in the output stream.

Parameters

bytes GBytes
 

The GBytes to write.

 The data is owned by the caller of the function.
cancellable GCancellable
 

Optional cancellable object.

 The argument can be NULL.
 The data is owned by the caller of the function.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: gssize
 

Number of bytes written, or -1 on error.