Struct std::fs::Permissions
1.0.0 · source · [−]pub struct Permissions(_);
Expand description
Representation of the various permissions on a file.
This module only currently provides one bit of information,
Permissions::readonly
, which is exposed on all currently supported
platforms. Unix-specific functionality, such as mode bits, is available
through the PermissionsExt
trait.
Implementations
sourceimpl Permissions
impl Permissions
sourcepub fn set_readonly(&mut self, readonly: bool)
pub fn set_readonly(&mut self, readonly: bool)
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 set_permissions
function.
Examples
use std::fs::File;
fn main() -> std::io::Result<()> {
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());
Ok(())
}
RunTrait Implementations
sourceimpl Clone for Permissions
impl Clone for Permissions
sourcefn clone(&self) -> Permissions
fn clone(&self) -> Permissions
Returns a copy of the value. Read more
sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl Debug for Permissions
impl Debug for Permissions
sourceimpl PartialEq<Permissions> for Permissions
impl PartialEq<Permissions> for Permissions
sourcefn eq(&self, other: &Permissions) -> bool
fn eq(&self, other: &Permissions) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &Permissions) -> bool
fn ne(&self, other: &Permissions) -> bool
This method tests for !=
.
1.1.0 · sourceimpl PermissionsExt for Permissions
Available on Unix only.
impl PermissionsExt for Permissions
sourcefn mode(&self) -> u32
fn mode(&self) -> u32
Returns the underlying raw st_mode
bits that contain the standard
Unix permissions for this file. Read more
sourcefn set_mode(&mut self, mode: u32)
fn set_mode(&mut self, mode: u32)
Sets the underlying raw bits for this set of permissions. Read more
sourcefn from_mode(mode: u32) -> Permissions
fn from_mode(mode: u32) -> Permissions
Creates a new instance of Permissions
from the given set of Unix
permission bits. Read more
impl Eq for Permissions
impl StructuralEq for Permissions
impl StructuralPartialEq for Permissions
Auto Trait Implementations
impl RefUnwindSafe for Permissions
impl Send for Permissions
impl Sync for Permissions
impl Unpin for Permissions
impl UnwindSafe for Permissions
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
Uses borrowed data to replace owned data, usually by cloning. Read more