pub struct OFlag { /* private fields */ }
Expand description
Configuration options for opened files.
Implementations
impl OFlag
impl OFlag
pub const O_ASYNC: OFlag = Self{bits: libc::O_ASYNC,}
pub const O_ASYNC: OFlag = Self{bits: libc::O_ASYNC,}
Generate a signal when input or output becomes possible.
pub const O_CLOEXEC: OFlag = Self{bits: libc::O_CLOEXEC,}
pub const O_CLOEXEC: OFlag = Self{bits: libc::O_CLOEXEC,}
Closes the file descriptor once an execve
call is made.
Also sets the file offset to the beginning of the file.
pub const O_DIRECT: OFlag = Self{bits: libc::O_DIRECT,}
pub const O_DIRECT: OFlag = Self{bits: libc::O_DIRECT,}
Try to minimize cache effects of the I/O for this file.
pub const O_DIRECTORY: OFlag = Self{bits: libc::O_DIRECTORY,}
pub const O_DIRECTORY: OFlag = Self{bits: libc::O_DIRECTORY,}
If the specified path isn’t a directory, fail.
pub const O_DSYNC: OFlag = Self{bits: libc::O_DSYNC,}
pub const O_DSYNC: OFlag = Self{bits: libc::O_DSYNC,}
Implicitly follow each write()
with an fdatasync()
.
pub const O_LARGEFILE: OFlag = Self{bits: libc::O_LARGEFILE,}
pub const O_LARGEFILE: OFlag = Self{bits: libc::O_LARGEFILE,}
Allow files whose sizes can’t be represented in an off_t
to be opened.
pub const O_NOATIME: OFlag = Self{bits: libc::O_NOATIME,}
pub const O_NOATIME: OFlag = Self{bits: libc::O_NOATIME,}
Do not update the file last access time during read(2)
s.
pub const O_NOCTTY: OFlag = Self{bits: libc::O_NOCTTY,}
pub const O_NOCTTY: OFlag = Self{bits: libc::O_NOCTTY,}
Don’t attach the device as the process’ controlling terminal.
pub const O_NOFOLLOW: OFlag = Self{bits: libc::O_NOFOLLOW,}
pub const O_NOFOLLOW: OFlag = Self{bits: libc::O_NOFOLLOW,}
open()
will fail if the given path is a symbolic link.
pub const O_NONBLOCK: OFlag = Self{bits: libc::O_NONBLOCK,}
pub const O_NONBLOCK: OFlag = Self{bits: libc::O_NONBLOCK,}
When possible, open the file in nonblocking mode.
pub const O_PATH: OFlag = Self{bits: libc::O_PATH,}
pub const O_PATH: OFlag = Self{bits: libc::O_PATH,}
Obtain a file descriptor for low-level access.
The file itself is not opened and other file operations will fail.
pub const O_RDONLY: OFlag = Self{bits: libc::O_RDONLY,}
pub const O_RDONLY: OFlag = Self{bits: libc::O_RDONLY,}
Only allow reading.
This should not be combined with O_WRONLY
or O_RDWR
.
pub const O_RDWR: OFlag = Self{bits: libc::O_RDWR,}
pub const O_RDWR: OFlag = Self{bits: libc::O_RDWR,}
Allow both reading and writing.
This should not be combined with O_WRONLY
or O_RDONLY
.
pub const O_RSYNC: OFlag = Self{bits: libc::O_RSYNC,}
pub const O_RSYNC: OFlag = Self{bits: libc::O_RSYNC,}
Similar to O_DSYNC
but applies to read
s instead.
pub const O_TRUNC: OFlag = Self{bits: libc::O_TRUNC,}
pub const O_TRUNC: OFlag = Self{bits: libc::O_TRUNC,}
Truncate an existing regular file to 0 length if it allows writing.
pub const O_WRONLY: OFlag = Self{bits: libc::O_WRONLY,}
pub const O_WRONLY: OFlag = Self{bits: libc::O_WRONLY,}
Only allow writing.
This should not be combined with O_RDONLY
or O_RDWR
.
pub const fn from_bits(bits: i32) -> Option<OFlag>
pub const fn from_bits(bits: i32) -> Option<OFlag>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
pub const fn from_bits_truncate(bits: i32) -> OFlag
pub const fn from_bits_truncate(bits: i32) -> OFlag
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
pub const unsafe fn from_bits_unchecked(bits: i32) -> OFlag
pub const unsafe fn from_bits_unchecked(bits: i32) -> OFlag
Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).
Safety
The caller of the bitflags!
macro can chose to allow or
disallow extra bits for their bitflags type.
The caller of from_bits_unchecked()
has to ensure that
all bits correspond to a defined flag or that extra bits
are valid for this bitflags type.
pub const fn intersects(&self, other: OFlag) -> bool
pub const fn intersects(&self, other: OFlag) -> bool
Returns true
if there are flags common to both self
and other
.
pub const fn contains(&self, other: OFlag) -> bool
pub const fn contains(&self, other: OFlag) -> bool
Returns true
if all of the flags in other
are contained within self
.
pub fn set(&mut self, other: OFlag, value: bool)
pub fn set(&mut self, other: OFlag, value: bool)
Inserts or removes the specified flags depending on the passed value.
pub const fn intersection(self, other: OFlag) -> OFlag
pub const fn intersection(self, other: OFlag) -> OFlag
Returns the intersection between the flags in self
and
other
.
Specifically, the returned set contains only the flags which are
present in both self
and other
.
This is equivalent to using the &
operator (e.g.
ops::BitAnd
), as in flags & other
.
pub const fn union(self, other: OFlag) -> OFlag
pub const fn union(self, other: OFlag) -> OFlag
Returns the union of between the flags in self
and other
.
Specifically, the returned set contains all flags which are
present in either self
or other
, including any which are
present in both (see Self::symmetric_difference
if that
is undesirable).
This is equivalent to using the |
operator (e.g.
ops::BitOr
), as in flags | other
.
pub const fn difference(self, other: OFlag) -> OFlag
pub const fn difference(self, other: OFlag) -> OFlag
Returns the difference between the flags in self
and other
.
Specifically, the returned set contains all flags present in
self
, except for the ones present in other
.
It is also conceptually equivalent to the “bit-clear” operation:
flags & !other
(and this syntax is also supported).
This is equivalent to using the -
operator (e.g.
ops::Sub
), as in flags - other
.
pub const fn symmetric_difference(self, other: OFlag) -> OFlag
pub const fn symmetric_difference(self, other: OFlag) -> OFlag
Returns the symmetric difference between the flags
in self
and other
.
Specifically, the returned set contains the flags present which
are present in self
or other
, but that are not present in
both. Equivalently, it contains the flags present in exactly
one of the sets self
and other
.
This is equivalent to using the ^
operator (e.g.
ops::BitXor
), as in flags ^ other
.
pub const fn complement(self) -> OFlag
pub const fn complement(self) -> OFlag
Returns the complement of this set of flags.
Specifically, the returned set contains all the flags which are
not set in self
, but which are allowed for this type.
Alternatively, it can be thought of as the set difference
between Self::all()
and self
(e.g. Self::all() - self
)
This is equivalent to using the !
operator (e.g.
ops::Not
), as in !flags
.
Trait Implementations
impl BitAndAssign<OFlag> for OFlag
impl BitAndAssign<OFlag> for OFlag
fn bitand_assign(&mut self, other: OFlag)
fn bitand_assign(&mut self, other: OFlag)
Disables all flags disabled in the set.
impl BitOrAssign<OFlag> for OFlag
impl BitOrAssign<OFlag> for OFlag
fn bitor_assign(&mut self, other: OFlag)
fn bitor_assign(&mut self, other: OFlag)
Adds the set of flags.
impl BitXorAssign<OFlag> for OFlag
impl BitXorAssign<OFlag> for OFlag
fn bitxor_assign(&mut self, other: OFlag)
fn bitxor_assign(&mut self, other: OFlag)
Toggles the set of flags.
impl Extend<OFlag> for OFlag
impl Extend<OFlag> for OFlag
fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = OFlag>,
fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = OFlag>,
Extends a collection with the contents of an iterator. Read more
sourcefn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)Extends a collection with exactly one element.
sourcefn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)Reserves capacity in a collection for the given number of additional elements. Read more
impl FromIterator<OFlag> for OFlag
impl FromIterator<OFlag> for OFlag
fn from_iter<T>(iterator: T) -> OFlag where
T: IntoIterator<Item = OFlag>,
fn from_iter<T>(iterator: T) -> OFlag where
T: IntoIterator<Item = OFlag>,
Creates a value from an iterator. Read more
impl Ord for OFlag
impl Ord for OFlag
impl PartialOrd<OFlag> for OFlag
impl PartialOrd<OFlag> for OFlag
fn partial_cmp(&self, other: &OFlag) -> Option<Ordering>
fn partial_cmp(&self, other: &OFlag) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl SubAssign<OFlag> for OFlag
impl SubAssign<OFlag> for OFlag
fn sub_assign(&mut self, other: OFlag)
fn sub_assign(&mut self, other: OFlag)
Disables all flags enabled in the set.
impl Copy for OFlag
impl Eq for OFlag
impl StructuralEq for OFlag
impl StructuralPartialEq for OFlag
Auto Trait Implementations
impl RefUnwindSafe for OFlag
impl Send for OFlag
impl Sync for OFlag
impl Unpin for OFlag
impl UnwindSafe for OFlag
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> Downcast for T where
T: Any,
impl<T> Downcast for T where
T: Any,
sourcefn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>ⓘNotable traits for Box<W, Global>impl<W> Write for Box<W, Global> where
W: Write + ?Sized, impl<R> Read for Box<R, Global> where
R: Read + ?Sized, impl<I, A> Iterator for Box<I, A> where
I: Iterator + ?Sized,
A: Allocator, type Item = <I as Iterator>::Item;
fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>ⓘNotable traits for Box<W, Global>impl<W> Write for Box<W, Global> where
W: Write + ?Sized, impl<R> Read for Box<R, Global> where
R: Read + ?Sized, impl<I, A> Iterator for Box<I, A> where
I: Iterator + ?Sized,
A: Allocator, type Item = <I as Iterator>::Item;
W: Write + ?Sized, impl<R> Read for Box<R, Global> where
R: Read + ?Sized, impl<I, A> Iterator for Box<I, A> where
I: Iterator + ?Sized,
A: Allocator, type Item = <I as Iterator>::Item;
Convert Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
sourcefn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more
sourceimpl<T> DowncastSync for T where
T: Any + Send + Sync,
impl<T> DowncastSync for T where
T: Any + Send + Sync,
sourceimpl<A> DynCastExt for A
impl<A> DynCastExt for A
sourcefn dyn_cast<T>(
self
) -> Result<<A as DynCastExtHelper<T>>::Target, <A as DynCastExtHelper<T>>::Source> where
A: DynCastExtHelper<T>,
T: ?Sized,
fn dyn_cast<T>(
self
) -> Result<<A as DynCastExtHelper<T>>::Target, <A as DynCastExtHelper<T>>::Source> where
A: DynCastExtHelper<T>,
T: ?Sized,
Use this to cast from one trait object type to another. Read more
sourcefn dyn_upcast<T>(self) -> <A as DynCastExtAdvHelper<T, T>>::Target where
A: DynCastExtAdvHelper<T, T, Source = <A as DynCastExtAdvHelper<T, T>>::Target>,
T: ?Sized,
fn dyn_upcast<T>(self) -> <A as DynCastExtAdvHelper<T, T>>::Target where
A: DynCastExtAdvHelper<T, T, Source = <A as DynCastExtAdvHelper<T, T>>::Target>,
T: ?Sized,
Use this to upcast a trait to one of its supertraits. Read more
sourcefn dyn_cast_adv<F, T>(
self
) -> Result<<A as DynCastExtAdvHelper<F, T>>::Target, <A as DynCastExtAdvHelper<F, T>>::Source> where
A: DynCastExtAdvHelper<F, T>,
F: ?Sized,
T: ?Sized,
fn dyn_cast_adv<F, T>(
self
) -> Result<<A as DynCastExtAdvHelper<F, T>>::Target, <A as DynCastExtAdvHelper<F, T>>::Source> where
A: DynCastExtAdvHelper<F, T>,
F: ?Sized,
T: ?Sized,
sourcefn dyn_cast_with_config<C>(
self
) -> Result<<A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Target, <A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Source> where
C: DynCastConfig,
A: DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>,
fn dyn_cast_with_config<C>(
self
) -> Result<<A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Target, <A as DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>>::Source> where
C: DynCastConfig,
A: DynCastExtAdvHelper<<C as DynCastConfig>::Source, <C as DynCastConfig>::Target>,
Use this to cast from one trait object type to another. With this method the type parameter is a config type that uniquely specifies which cast should be preformed. Read more