Function

Giopollable_stream_write

Declaration

gssize
g_pollable_stream_write (
  GOutputStream* stream,
  void* buffer,
  gsize count,
  gboolean blocking,
  GCancellable* cancellable,
  GError** error
)

Description

Tries to write to stream, as with g_output_stream_write() (if blocking is TRUE) or g_pollable_output_stream_write_nonblocking() (if blocking is FALSE). This can be used to more easily share code between blocking and non-blocking implementations of a method.

If blocking is FALSE, then stream must be a GPollableOutputStream for which g_pollable_output_stream_can_poll() returns TRUE or else the behavior is undefined. If blocking is TRUE, then stream does not need to be a GPollableOutputStream.

Available since:

2.34

Parameters

`stream`	`GOutputStream`
	A `GOutputStream`.
	The data is owned by the caller of the function.
`buffer`	An array of `guint8`
	The buffer containing the data to write.
	The length of the array is specified in the `count` argument.
	The data is owned by the caller of the function.
`count`	`gsize`
	The number of bytes to write.
`blocking`	`gboolean`
	Whether to do blocking I/O.
`cancellable`	`GCancellable`
	Optional `GCancellable` object, `NULL` to ignore.
	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`
	The number of bytes written, or -1 on error.