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

fn readonly(&self) -> bool

Returns whether these permissions describe a readonly file.

Examples

fn main() { use std::fs::File; fn foo() -> std::io::Result<()> { let mut f = try!(File::create("foo.txt")); let metadata = try!(f.metadata()); assert_eq!(false, metadata.permissions().readonly()); Ok(()) } }

use std::fs::File;

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

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

fn set_readonly(&mut self, readonly: bool)

Modifies the readonly flag for this set of permissions.

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

Examples

fn main() { use std::fs::File; fn foo() -> std::io::Result<()> { let f = try!(File::create("foo.txt")); let metadata = try!(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()); Ok(()) } }

use std::fs::File;

let f = try!(File::create("foo.txt"));
let metadata = try!(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 PermissionsExt for Permissions

fn mode(&self) -> u32

Returns the underlying raw mode_t bits that are the standard Unix permissions for this file.

fn set_mode(&mut self, mode: u32)

Sets the underlying raw bits for this set of permissions.

fn from_mode(mode: u32) -> Permissions

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

Derived Implementations

impl Debug for Permissions

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Eq for Permissions

impl PartialEq for Permissions

fn eq(&self, __arg_0: &Permissions) -> bool

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

fn ne(&self, __arg_0: &Permissions) -> bool

This method tests for !=.

impl Clone for Permissions

fn clone(&self) -> Permissions

Returns a copy of the value.

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

Performs copy-assignment from source.