gio.FileInputStream

Ancestry

+-- gobject.GObject
  +-- gio.InputStream
    +-- gio.FileInputStream

Implemented Interfaces

gio.FileInputStream implements gio.Seekable

Description

gio.FileInputStream provides input streams that take their content from a file.

gio.FileInputStream implements gio.Seekable, which allows the input stream to jump to arbitrary positions in the file, provided the filesystem of the file allows it. In addition to the generic g_seekable_ API, gio.FileInputStream has its own API for seeking and positioning. To find the position of a file input stream, use gio.Seekable.tell(). To find out if a file input stream supports seeking, use gio.Seekable.can_seek(). To position a file input stream, use gio.Seekable.seek().

Methods

gio.FileInputStream.query_info

    def query_info(attributes, cancellable=None)

`attributes` :	a file attribute query string.
`cancellable` :	optional `gio.Cancellable` object, `None` to ignore.
Returns :	a `gio.FileInfo`, or `None` on error.

The query_info() method queries a file input stream the given attributes. This function blocks while querying the stream. For the asynchronous (non-blocking) version of this function, see gio.FileInputStream.query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with gio.ERROR_PENDING.

gio.FileInputStream.query_info_async

    def query_info_async(attributes, callback, io_priority=glib.PRIORITY_DEFAULT, cancellable=None, user_data=None)

`attributes` :	a file attribute query string.
`callback` :	a GAsyncReadyCallback to call when the request is satisfied.
`io_priority` :	the Glib Priority Constants of the request.
`cancellable` :	optional `gio.Cancellable` object, `None` to ignore.
`user_data` :	the data to pass to callback function.

The query_info_async() method queries the stream information asynchronously. When the operation is finished callback will be called. You can then call gio.FileInputStream.query_info_finish() to get the result of the operation.

For the synchronous version of this function, see gio.FileInputStream.query_info().

If cancellable is not None, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error gio.ERROR_CANCELLED will be set

gio.FileInputStream.query_info_finish

    def query_info_finish(result)

`result` :	a `gio.AsyncResult`.
Returns :	a `gio.FileInfo`, or `None` on error.

The query_info_finish() method finishes an asynchronous file append operation started with gio.FileInputStream.query_info_async().

Prev	Up	Next
gio.FileInfo	Home	gio.FileMonitor