Struct rustix::io::PollFlags
pub struct PollFlags { /* fields hidden */ }
Documentation
POLL*
flags for use with poll
.
Implementations
impl PollFlags
const IN: Self = _
POLLIN
const PRI: Self = _
POLLPRI
const OUT: Self = _
POLLOUT
const RDNORM: Self = _
POLLNORM
const WRNORM: Self = _
POLLNORM
const RDBAND: Self = _
POLLRDBAND
const WRBAND: Self = _
POLLWRBAND
const ERR: Self = _
POLLERR
const HUP: Self = _
POLLHUP
const NVAL: Self = _
POLLNVAL
const RDHUP: Self = _
POLLRDHUP
pub const fn empty() -> Self
Returns an empty set of flags.
pub const fn all() -> Self
Returns the set containing all flags.
pub const fn bits(&Self) -> u16
Returns the raw value of the flags currently stored.
pub const fn from_bits(bits: u16) -> $crate::_core::option::Option<Self>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
pub const fn from_bits_truncate(bits: u16) -> Self
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
pub const unsafe fn from_bits_unchecked(bits: u16) -> Self
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 is_empty(&Self) -> bool
Returns true
if no flags are currently stored.
pub const fn is_all(&Self) -> bool
Returns true
if all flags are currently set.
pub const fn intersects(&Self, other: Self) -> bool
Returns true
if there are flags common to both self
and other
.
pub const fn contains(&Self, other: Self) -> bool
Returns true
if all of the flags in other
are contained within self
.
pub fn insert(&mut Self, other: Self)
Inserts the specified flags in-place.
pub fn remove(&mut Self, other: Self)
Removes the specified flags in-place.
pub fn toggle(&mut Self, other: Self)
Toggles the specified flags in-place.
pub fn set(
&mut Self,
other: Self,
value: bool
)
&mut Self,
other: Self,
value: bool
)
Inserts or removes the specified flags depending on the passed value.
#[must_use]
pub const fn intersection(Self, other: Self) -> Self
pub const fn intersection(Self, other: Self) -> Self
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
.
#[must_use]
pub const fn union(Self, other: Self) -> Self
pub const fn union(Self, other: Self) -> Self
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
.
#[must_use]
pub const fn difference(Self, other: Self) -> Self
pub const fn difference(Self, other: Self) -> Self
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
.
#[must_use]
pub const fn symmetric_difference(Self, other: Self) -> Self
pub const fn symmetric_difference(Self, other: Self) -> Self
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
.
#[must_use]
pub const fn complement(Self) -> Self
pub const fn complement(Self) -> Self
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 Binary for PollFlags
fn fmt(&Self, f: &mut $crate::_core::fmt::Formatter<'_>) -> $crate::_core::fmt::Result
impl BitAndAssign<PollFlags> for PollFlags
fn bitand_assign(&mut Self, other: Self)
Disables all flags disabled in the set.
impl BitOrAssign<PollFlags> for PollFlags
fn bitor_assign(&mut Self, other: Self)
Adds the set of flags.
impl BitXorAssign<PollFlags> for PollFlags
fn bitxor_assign(&mut Self, other: Self)
Toggles the set of flags.
impl Debug for PollFlags
fn fmt(&Self, f: &mut $crate::_core::fmt::Formatter<'_>) -> $crate::_core::fmt::Result
impl Extend<PollFlags> for PollFlags
fn extend<T: $crate::_core::iter::IntoIterator<Item = Self>>(&mut Self, iterator: T)
impl FromIterator<PollFlags> for PollFlags
fn from_iter<T: $crate::_core::iter::IntoIterator<Item = Self>>(iterator: T) -> Self
impl Hash for PollFlags
fn hash<__H: $crate::hash::Hasher>(&Self, state: &mut __H) -> ()
impl LowerHex for PollFlags
fn fmt(&Self, f: &mut $crate::_core::fmt::Formatter<'_>) -> $crate::_core::fmt::Result
impl Octal for PollFlags
fn fmt(&Self, f: &mut $crate::_core::fmt::Formatter<'_>) -> $crate::_core::fmt::Result
impl Ord for PollFlags
fn cmp(&Self, other: &PollFlags) -> $crate::cmp::Ordering
impl PartialOrd<PollFlags> for PollFlags
fn partial_cmp(&Self, other: &PollFlags) -> $crate::option::Option<$crate::cmp::Ordering>
impl StructuralEq for PollFlags
impl StructuralPartialEq for PollFlags
impl SubAssign<PollFlags> for PollFlags
fn sub_assign(&mut Self, other: Self)
Disables all flags enabled in the set.
impl UpperHex for PollFlags
fn fmt(&Self, f: &mut $crate::_core::fmt::Formatter<'_>) -> $crate::_core::fmt::Result
Auto Trait Implementations
impl RefUnwindSafe for PollFlags
impl UnwindSafe for PollFlags
Blanket Implementations
impl<T> BorrowMut<T> for T
where
T: ?Sized,
where
T: ?Sized,
fn borrow_mut(&mut Self) -> &mut T