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.