GLibUnix.Pipe.steal
Description: Reference for GLibUnix.Pipe.steal

### Function

# GLibUnix Pipesteal

since: 2.80

#### Declaration [src]

    int
    g_unix_pipe_steal (
      GUnixPipe* self,
      GUnixPipeEnd end
    )

#### Description [src]

Return one of the ends of the pipe. It becomes owned by the caller, and the file descriptor in the data structure is set to `-1`, similar to g_steal_fd().

This function is async-signal safe (see `signal(7)` and `signal-safety(7)`), making it safe to call from a signal handler or a `GSpawnChildSetupFunc`.

This function preserves the value of `errno`.

Available since: 2.80

This function is not directly available to language bindings.

#### Parameters

`self`

  Type: `GUnixPipe`

  A pair of file descriptors.

  The data is owned by the caller of the function.

`end`

  Type: `GUnixPipeEnd`

  One of the ends of the pipe.

#### Return value

Type: `int`

A non-negative file descriptor, which becomes owned by the caller and must be closed by the caller if required, or a negative number if the corresponding end of the pipe was already closed or stolen.