Struct FileAccessToken 

pub struct FileAccessToken { /* private fields */ }

A serializable capability token representing access to a user-selected file.

Obtain instances from crate::FilePicker methods. Serialize via serialize for storage; deserialize to reopen files across app restarts.

Implementations

impl FileAccessToken

pub fn open_read(&self) -> Result<Box<dyn ReadSeek>, AccessError>

Open the file for reading. Returns Read + Seek.

Errors

Returns AccessError if permission is revoked or the file cannot be opened.

pub fn open_write(&self) -> Result<Box<dyn WriteSeek>, AccessError>

Open the file for writing. Returns Write + Seek.

Errors

Returns AccessError if permission is revoked or the file cannot be opened.

pub fn display_name(&self) -> &str

Returns the user-visible display name of the file (typically the filename).

pub fn mime_type(&self) -> Option<&str>

Returns the MIME type of the file, if known. Desktop returns None.

pub fn check_permission(&self) -> PermissionStatus

Check whether the permission grant for this file is still valid.

pub fn serialize(&self) -> String

Serialize the token to a URL-safe base64-encoded string for storage.

pub fn deserialize(s: &str) -> Result<Self, TokenParseError>

Deserialize a token from a string previously returned by serialize.

Errors

Returns TokenParseError if the string is malformed.

Trait Implementations

impl Clone for FileAccessToken

fn clone(&self) -> FileAccessToken

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileAccessToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for FileAccessToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for FileAccessToken

type Err = TokenParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.