Gio.UnixInputStream

g GObject.GInterface GObject.GInterface Gio.FileDescriptorBased Gio.FileDescriptorBased GObject.GInterface->Gio.FileDescriptorBased Gio.PollableInputStream Gio.PollableInputStream GObject.GInterface->Gio.PollableInputStream GObject.Object GObject.Object Gio.InputStream Gio.InputStream GObject.Object->Gio.InputStream Gio.UnixInputStream Gio.UnixInputStream Gio.FileDescriptorBased->Gio.UnixInputStream Gio.InputStream->Gio.UnixInputStream Gio.PollableInputStream->Gio.UnixInputStream

Subclasses:

None

Methods

Inherited:

Gio.InputStream (19), GObject.Object (37), Gio.FileDescriptorBased (1), Gio.PollableInputStream (4)

Structs:

GObject.ObjectClass (5)

class

new (fd, close_fd)

get_close_fd ()

get_fd ()

set_close_fd (close_fd)

Virtual Methods

Inherited:

Gio.InputStream (9), GObject.Object (7), Gio.FileDescriptorBased (1), Gio.PollableInputStream (4)

Properties

Name

Type

Flags

Short Description

close-fd

bool

r/w

Whether to close the file descriptor when the stream is closed

fd

int

r/w/co

The file descriptor to read from

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent_instance

Gio.InputStream

r

Class Details

class Gio.UnixInputStream(**kwargs)
Bases:

Gio.InputStream, Gio.FileDescriptorBased, Gio.PollableInputStream

Abstract:

No

Structure:

Gio.UnixInputStreamClass

Gio.UnixInputStream implements Gio.InputStream for reading from a UNIX file descriptor, including asynchronous operations. (If the file descriptor refers to a socket or pipe, this will use poll() to do asynchronous I/O. If it refers to a regular file, it will fall back to doing asynchronous I/O in another thread.)

Note that <gio/gunixinputstream.h> belongs to the UNIX-specific GIO interfaces, thus you have to use the gio-unix-2.0.pc pkg-config file when using it.

classmethod new(fd, close_fd)[source]
Parameters:
  • fd (int) – a UNIX file descriptor

  • close_fd (bool) – True to close the file descriptor when done

Returns:

a new Gio.UnixInputStream

Return type:

Gio.InputStream

Creates a new Gio.UnixInputStream for the given fd.

If close_fd is True, the file descriptor will be closed when the stream is closed.

get_close_fd()[source]
Returns:

True if the file descriptor is closed when done

Return type:

bool

Returns whether the file descriptor of self will be closed when the stream is closed.

New in version 2.20.

get_fd()[source]
Returns:

The file descriptor of self

Return type:

int

Return the UNIX file descriptor that the stream reads from.

New in version 2.20.

set_close_fd(close_fd)[source]
Parameters:

close_fd (bool) – True to close the file descriptor when done

Sets whether the file descriptor of self shall be closed when the stream is closed.

New in version 2.20.

Property Details

Gio.UnixInputStream.props.close_fd
Name:

close-fd

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE

Whether to close the file descriptor when the stream is closed.

New in version 2.20.

Gio.UnixInputStream.props.fd
Name:

fd

Type:

int

Default Value:

-1

Flags:

READABLE, WRITABLE, CONSTRUCT_ONLY

The file descriptor that the stream reads from.

New in version 2.20.