/rust/registry/src/index.crates.io-1949cf8c6b5b557f/bitflags-2.4.0/src/iter.rs

Source
/*!
Yield the bits of a source flags value in a set of contained flags values.
*/

use crate::{Flag, Flags};

/**
An iterator over flags values.

This iterator will yield flags values for contained, defined flags first, with any remaining bits yielded
as a final flags value.
*/
pub struct Iter<B: 'static> {
    inner: IterNames<B>,
    done: bool,
}

impl<B: Flags> Iter<B> {
    pub(crate) fn new(flags: &B) -> Self {
        Iter {
            inner: IterNames::new(flags),
            done: false,
        }
    }
}

impl<B: 'static> Iter<B> {
    // Used by the `bitflags` macro
    #[doc(hidden)]
    pub const fn __private_const_new(flags: &'static [Flag<B>], source: B, remaining: B) -> Self {
        Iter {
            inner: IterNames::__private_const_new(flags, source, remaining),
            done: false,
        }
    }
}

impl<B: Flags> Iterator for Iter<B> {
    type Item = B;

    fn next(&mut self) -> Option<Self::Item> {
        match self.inner.next() {
            Some((_, flag)) => Some(flag),
            None if !self.done => {
                self.done = true;

                // After iterating through valid names, if there are any bits left over
                // then return one final value that includes them. This makes `into_iter`
                // and `from_iter` roundtrip
                if !self.inner.remaining().is_empty() {
                    Some(B::from_bits_retain(self.inner.remaining.bits()))
                } else {
                    None
                }
            }
            None => None,
        }
    }
}

/**
An iterator over flags values.

This iterator only yields flags values for contained, defined, named flags. Any remaining bits
won't be yielded, but can be found with the [`IterNames::remaining`] method.
*/
pub struct IterNames<B: 'static> {
    flags: &'static [Flag<B>],
    idx: usize,
    source: B,
    remaining: B,
}

impl<B: Flags> IterNames<B> {
    pub(crate) fn new(flags: &B) -> Self {
        IterNames {
            flags: B::FLAGS,
            idx: 0,
            remaining: B::from_bits_retain(flags.bits()),
            source: B::from_bits_retain(flags.bits()),
        }
    }
}

impl<B: 'static> IterNames<B> {
    // Used by the bitflags macro
    #[doc(hidden)]
    pub const fn __private_const_new(flags: &'static [Flag<B>], source: B, remaining: B) -> Self {
        IterNames {
            flags,
            idx: 0,
            remaining,
            source,
        }
    }

    /// Get a flags value of any remaining bits that haven't been yielded yet.
    ///
    /// Once the iterator has finished, this method can be used to
    /// check whether or not there are any bits that didn't correspond
    /// to a contained, defined, named flag remaining.
    pub fn remaining(&self) -> &B {
        &self.remaining
    }
}

impl<B: Flags> Iterator for IterNames<B> {
    type Item = (&'static str, B);

    fn next(&mut self) -> Option<Self::Item> {
        while let Some(flag) = self.flags.get(self.idx) {
            // Short-circuit if our state is empty
            if self.remaining.is_empty() {
                return None;
            }

            self.idx += 1;

            // Skip unnamed flags
            if flag.name().is_empty() {
                continue;
            }

            let bits = flag.value().bits();

            // If the flag is set in the original source _and_ it has bits that haven't
            // been covered by a previous flag yet then yield it. These conditions cover
            // two cases for multi-bit flags:
            //
            // 1. When flags partially overlap, such as `0b00000001` and `0b00000101`, we'll
            // yield both flags.
            // 2. When flags fully overlap, such as in convenience flags that are a shorthand for others,
            // we won't yield both flags.
            if self.source.contains(B::from_bits_retain(bits))
                && self.remaining.intersects(B::from_bits_retain(bits))
            {
                self.remaining.remove(B::from_bits_retain(bits));

                return Some((flag.name(), B::from_bits_retain(bits)));
            }
        }

        None
    }
}

Line	Count	Source
1		/*!
2		Yield the bits of a source flags value in a set of contained flags values.
3		*/
4
5		use crate::{Flag, Flags};
6
7		/**
8		An iterator over flags values.
9
10		This iterator will yield flags values for contained, defined flags first, with any remaining bits yielded
11		as a final flags value.
12		*/
13		pub struct Iter<B: 'static> {
14		inner: IterNames<B>,
15		done: bool,
16		}
17
18		impl<B: Flags> Iter<B> {
19	0	pub(crate) fn new(flags: &B) -> Self {
20	0	Iter {
21	0	inner: IterNames::new(flags),
22	0	done: false,
23	0	}
24	0	}
25		}
26
27		impl<B: 'static> Iter<B> {
28		// Used by the `bitflags` macro
29		#[doc(hidden)]
30	0	pub const fn __private_const_new(flags: &'static [Flag<B>], source: B, remaining: B) -> Self {
31	0	Iter {
32	0	inner: IterNames::__private_const_new(flags, source, remaining),
33	0	done: false,
34	0	}
35	0	} Unexecuted instantiation: <bitflags::iter::Iter<fuse::sys::IoctlFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<fuse::sys::OpenOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<fuse::sys::SetattrValid>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<fuse::sys::SetUpMappingFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<fuse::sys::FsOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vmm_vhost::message::VhostUserHeaderFlag>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vmm_vhost::message::VhostUserConfigFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vmm_vhost::message::VhostUserVringAddrFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vmm_vhost::message::VhostUserProtocolFeatures>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vmm_vhost::message::VhostUserShmemMapMsgFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::fs::ioctl::IFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::fs::statx::StatxFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::fs::statx::StatxAttributes>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::fs::xattr::XattrFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::SocketFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::xdp::XdpRingFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::xdp::XdpDescOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::xdp::XdpOptionsFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::xdp::XdpUmemRegFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::net::types::xdp::SocketAddrXdpFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::MemfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::RenameFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::ResolveFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::FallocateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::StatVfsMountFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::Mode>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::Access>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::OFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::AtFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::types::SealFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::inotify::WatchFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::inotify::CreateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::fs::inotify::ReadFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::io::types::ReadWriteFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::io::types::FdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::io::types::DupFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MlockFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MsyncFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MremapFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MlockAllFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MprotectFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::UserfaultfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::MapFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::mm::types::ProtFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::net::send_recv::ReturnFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::net::send_recv::RecvFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::net::send_recv::SendFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::pipe::types::SpliceFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::pipe::types::PipeFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::event::epoll::EventFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::event::epoll::CreateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::event::types::EventfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<rustix::backend::event::poll_fd::PollFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<vm_memory::guest_memory::sys::linux::MemoryPolicy>>::__private_const_new Unexecuted instantiation: <bitflags::iter::Iter<_>>::__private_const_new
36		}
37
38		impl<B: Flags> Iterator for Iter<B> {
39		type Item = B;
40
41	0	fn next(&mut self) -> Option<Self::Item> {
42	0	match self.inner.next() {
43	0	Some((_, flag)) => Some(flag),
44	0	None if !self.done => {
45	0	self.done = true;
46
47		// After iterating through valid names, if there are any bits left over
48		// then return one final value that includes them. This makes `into_iter`
49		// and `from_iter` roundtrip
50	0	if !self.inner.remaining().is_empty() {
51	0	Some(B::from_bits_retain(self.inner.remaining.bits()))
52		} else {
53	0	None
54		}
55		}
56	0	None => None,
57		}
58	0	}
59		}
60
61		/**
62		An iterator over flags values.
63
64		This iterator only yields flags values for contained, defined, named flags. Any remaining bits
65		won't be yielded, but can be found with the [`IterNames::remaining`] method.
66		*/
67		pub struct IterNames<B: 'static> {
68		flags: &'static [Flag<B>],
69		idx: usize,
70		source: B,
71		remaining: B,
72		}
73
74		impl<B: Flags> IterNames<B> {
75	0	pub(crate) fn new(flags: &B) -> Self {
76	0	IterNames {
77	0	flags: B::FLAGS,
78	0	idx: 0,
79	0	remaining: B::from_bits_retain(flags.bits()),
80	0	source: B::from_bits_retain(flags.bits()),
81	0	}
82	0	} Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::IoctlFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::OpenOptions>>::new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetattrValid>>::new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetUpMappingFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::FsOptions>>::new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserHeaderFlag>>::new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserConfigFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserVringAddrFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserProtocolFeatures>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::ioctl::IFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxAttributes>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::xattr::XattrFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::SocketFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpRingFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpDescOptions>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpOptionsFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpUmemRegFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::SocketAddrXdpFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::MemfdFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::RenameFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::ResolveFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::FallocateFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::StatVfsMountFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Mode>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Access>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::OFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::AtFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::SealFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::WatchFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::CreateFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::ReadFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::ReadWriteFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::FdFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::DupFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MsyncFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MremapFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockAllFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MprotectFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::UserfaultfdFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MapFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::ProtFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::ReturnFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::RecvFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::SendFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::SpliceFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::PipeFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::EventFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::CreateFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::types::EventfdFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::poll_fd::PollFlags>>::new Unexecuted instantiation: <bitflags::iter::IterNames<vm_memory::guest_memory::sys::linux::MemoryPolicy>>::new Unexecuted instantiation: <bitflags::iter::IterNames<_>>::new
83		}
84
85		impl<B: 'static> IterNames<B> {
86		// Used by the bitflags macro
87		#[doc(hidden)]
88	0	pub const fn __private_const_new(flags: &'static [Flag<B>], source: B, remaining: B) -> Self {
89	0	IterNames {
90	0	flags,
91	0	idx: 0,
92	0	remaining,
93	0	source,
94	0	}
95	0	} Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::IoctlFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::OpenOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetattrValid>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetUpMappingFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::FsOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserHeaderFlag>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserConfigFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserVringAddrFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserProtocolFeatures>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserShmemMapMsgFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::ioctl::IFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxAttributes>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::xattr::XattrFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::SocketFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpRingFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpDescOptions>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpOptionsFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpUmemRegFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::SocketAddrXdpFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::MemfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::RenameFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::ResolveFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::FallocateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::StatVfsMountFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Mode>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Access>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::OFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::AtFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::SealFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::WatchFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::CreateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::ReadFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::ReadWriteFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::FdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::DupFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MsyncFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MremapFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockAllFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MprotectFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::UserfaultfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MapFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::ProtFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::ReturnFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::RecvFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::SendFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::SpliceFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::PipeFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::EventFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::CreateFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::types::EventfdFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::poll_fd::PollFlags>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<vm_memory::guest_memory::sys::linux::MemoryPolicy>>::__private_const_new Unexecuted instantiation: <bitflags::iter::IterNames<_>>::__private_const_new
96
97		/// Get a flags value of any remaining bits that haven't been yielded yet.
98		///
99		/// Once the iterator has finished, this method can be used to
100		/// check whether or not there are any bits that didn't correspond
101		/// to a contained, defined, named flag remaining.
102	0	pub fn remaining(&self) -> &B {
103	0	&self.remaining
104	0	} Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::IoctlFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::OpenOptions>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetattrValid>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetUpMappingFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::FsOptions>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserHeaderFlag>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserConfigFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserVringAddrFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserProtocolFeatures>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::ioctl::IFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxAttributes>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::xattr::XattrFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::SocketFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpRingFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpDescOptions>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpOptionsFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpUmemRegFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::SocketAddrXdpFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::MemfdFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::RenameFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::ResolveFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::FallocateFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::StatVfsMountFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Mode>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Access>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::OFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::AtFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::SealFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::WatchFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::CreateFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::ReadFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::ReadWriteFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::FdFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::DupFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MsyncFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MremapFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockAllFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MprotectFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::UserfaultfdFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MapFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::ProtFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::ReturnFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::RecvFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::SendFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::SpliceFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::PipeFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::EventFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::CreateFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::types::EventfdFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::poll_fd::PollFlags>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<vm_memory::guest_memory::sys::linux::MemoryPolicy>>::remaining Unexecuted instantiation: <bitflags::iter::IterNames<_>>::remaining
105		}
106
107		impl<B: Flags> Iterator for IterNames<B> {
108		type Item = (&'static str, B);
109
110	0	fn next(&mut self) -> Option<Self::Item> {
111	0	while let Some(flag) = self.flags.get(self.idx) {
112		// Short-circuit if our state is empty
113	0	if self.remaining.is_empty() {
114	0	return None;
115	0	}
116
117	0	self.idx += 1;
118
119		// Skip unnamed flags
120	0	if flag.name().is_empty() {
121	0	continue;
122	0	}
123
124	0	let bits = flag.value().bits();
125
126		// If the flag is set in the original source _and_ it has bits that haven't
127		// been covered by a previous flag yet then yield it. These conditions cover
128		// two cases for multi-bit flags:
129		//
130		// 1. When flags partially overlap, such as `0b00000001` and `0b00000101`, we'll
131		// yield both flags.
132		// 2. When flags fully overlap, such as in convenience flags that are a shorthand for others,
133		// we won't yield both flags.
134	0	if self.source.contains(B::from_bits_retain(bits))
135	0	&& self.remaining.intersects(B::from_bits_retain(bits))
136		{
137	0	self.remaining.remove(B::from_bits_retain(bits));
138
139	0	return Some((flag.name(), B::from_bits_retain(bits)));
140	0	}
141		}
142
143	0	None
144	0	} Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::IoctlFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::OpenOptions> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetattrValid> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::SetUpMappingFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<fuse::sys::FsOptions> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserHeaderFlag> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserConfigFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserVringAddrFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<vmm_vhost::message::VhostUserProtocolFeatures> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::ioctl::IFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::statx::StatxAttributes> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::fs::xattr::XattrFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::SocketFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpRingFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpDescOptions> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpOptionsFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::XdpUmemRegFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::net::types::xdp::SocketAddrXdpFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::MemfdFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::RenameFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::ResolveFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::FallocateFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::StatVfsMountFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Mode> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::Access> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::OFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::AtFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::types::SealFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::WatchFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::CreateFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::fs::inotify::ReadFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::ReadWriteFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::FdFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::io::types::DupFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MsyncFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MremapFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MlockAllFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MprotectFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::UserfaultfdFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::MapFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::mm::types::ProtFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::ReturnFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::RecvFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::net::send_recv::SendFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::SpliceFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::pipe::types::PipeFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::EventFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::epoll::CreateFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::types::EventfdFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<rustix::backend::event::poll_fd::PollFlags> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<vm_memory::guest_memory::sys::linux::MemoryPolicy> as core::iter::traits::iterator::Iterator>::next Unexecuted instantiation: <bitflags::iter::IterNames<_> as core::iter::traits::iterator::Iterator>::next
145		}

Coverage Report

Created: 2025-11-16 06:34