W3cubDocs

/Rust

Struct std::fs::Permissions

pub struct Permissions(_);

Representation of the various permissions on a file.

This module only currently provides one bit of information, readonly, which is exposed on all currently supported platforms. Unix-specific functionality, such as mode bits, is available through the os::unix::PermissionsExt trait.

Methods

impl Permissions [src]

[src]

Returns whether these permissions describe a readonly (unwritable) file.

Examples

use std::fs::File;

let mut f = File::create("foo.txt")?;
let metadata = f.metadata()?;

assert_eq!(false, metadata.permissions().readonly());

[src]

Modifies the readonly flag for this set of permissions. If the readonly argument is true, using the resulting Permission will update file permissions to forbid writing. Conversely, if it's false, using the resulting Permission will update file permissions to allow writing.

This operation does not modify the filesystem. To modify the filesystem use the fs::set_permissions function.

Examples

use std::fs::File;

let f = File::create("foo.txt")?;
let metadata = f.metadata()?;
let mut permissions = metadata.permissions();

permissions.set_readonly(true);

// filesystem doesn't change
assert_eq!(false, metadata.permissions().readonly());

// just this particular `permissions`.
assert_eq!(true, permissions.readonly());

Trait Implementations

impl Clone for Permissions [src]

[src]

Returns a copy of the value. Read more

[src]

Performs copy-assignment from source. Read more

impl PartialEq for Permissions [src]

[src]

This method tests for self and other values to be equal, and is used by ==. Read more

[src]

This method tests for !=.

impl Eq for Permissions [src]

impl Debug for Permissions [src]

[src]

Formats the value using the given formatter. Read more

impl PermissionsExt for Permissions
1.1.0
[src]

[src]

This is supported on Unix only.

Returns the underlying raw st_mode bits that contain the standard Unix permissions for this file. Read more

[src]

This is supported on Unix only.

Sets the underlying raw bits for this set of permissions. Read more

[src]

This is supported on Unix only.

Creates a new instance of Permissions from the given set of Unix permission bits. Read more

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/fs/struct.Permissions.html