query_info


Description:

public virtual FileInfo query_info (string attributes, Cancellable? cancellable = null) throws Error

Queries a file io stream for the given attributes.

This function blocks while querying the stream. For the asynchronous version of this function, see 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 g_io_error_pending .

Can fail if the stream was already closed (with throws being set to g_io_error_closed), the stream has pending operations (with throws being set to g_io_error_pending), or if querying info is not supported for the stream's interface (with throws being set to g_io_error_not_supported). I all cases of failure, null will be returned.

If cancellable is not null, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error g_io_error_cancelled will be set, and null will be returned.

Parameters:

this

a FileIOStream.

attributes

a file attribute query string.

cancellable

optional Cancellable object, null to ignore.

Returns:

a FileInfo for the this, or null on error.




2022 vala-language.org