Trait gio::FileIOStreamExt

pub trait FileIOStreamExt: 'static {
    fn get_etag(&self) -> Option<GString>;
    fn query_info<P: IsA<Cancellable>>(
        &self, 
        attributes: &str, 
        cancellable: Option<&P>
    ) -> Result<FileInfo, Error>;
    fn query_info_async<P: IsA<Cancellable>, Q: FnOnce(Result<FileInfo, Error>) + Send + 'static>(
        &self, 
        attributes: &str, 
        io_priority: Priority, 
        cancellable: Option<&P>, 
        callback: Q
    );
    fn query_info_async_future(
        &self, 
        attributes: &str, 
        io_priority: Priority
    ) -> Pin<Box_<dyn Future<Output = Result<FileInfo, Error>> + 'static>>;
}

Trait containing all FileIOStream methods.

Implementors

FileIOStream

Required methods

fn get_etag(&self) -> Option<GString>

Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing.

Returns

the entity tag for the stream.

fn query_info<P: IsA<Cancellable>>(
    &self,
    attributes: &str,
    cancellable: Option<&P>
) -> Result<FileInfo, 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 FileIOStreamExt::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 IOErrorEnum::Pending.

Can fail if the stream was already closed (with error being set to IOErrorEnum::Closed), the stream has pending operations (with error being set to IOErrorEnum::Pending), or if querying info is not supported for the stream's interface (with error being set to IOErrorEnum::NotSupported). I all cases of failure, None will be returned.

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 IOErrorEnum::Cancelled will be set, and None will be returned.

attributes

a file attribute query string.

cancellable

optional Cancellable object, None to ignore.

Returns

a FileInfo for the self, or None on error.

fn query_info_async<P: IsA<Cancellable>, Q: FnOnce(Result<FileInfo, Error>) + Send + 'static>(
    &self,
    attributes: &str,
    io_priority: Priority,
    cancellable: Option<&P>,
    callback: Q
)

Asynchronously queries the self for a FileInfo. When completed, callback will be called with a AsyncResult which can be used to finish the operation with FileIOStreamExt::query_info_finish.

For the synchronous version of this function, see FileIOStreamExt::query_info.

attributes

a file attribute query string.

io_priority

the [I/O priority][gio-GIOScheduler] of the request

cancellable

optional Cancellable object, None to ignore.

callback

callback to call when the request is satisfied

user_data

the data to pass to callback function

fn query_info_async_future(
    &self,
    attributes: &str,
    io_priority: Priority
) -> Pin<Box_<dyn Future<Output = Result<FileInfo, Error>> + 'static>>

Loading content...

Implementors

impl<O: IsA<FileIOStream>> FileIOStreamExt for O

fn get_etag(&self) -> Option<GString>

fn query_info<P: IsA<Cancellable>>(
    &self,
    attributes: &str,
    cancellable: Option<&P>
) -> Result<FileInfo, Error>

fn query_info_async<P: IsA<Cancellable>, Q: FnOnce(Result<FileInfo, Error>) + Send + 'static>(
    &self,
    attributes: &str,
    io_priority: Priority,
    cancellable: Option<&P>,
    callback: Q
)

fn query_info_async_future(
    &self,
    attributes: &str,
    io_priority: Priority
) -> Pin<Box_<dyn Future<Output = Result<FileInfo, Error>> + 'static>>

Loading content...