summary refs log tree commit diff stats
path: root/rust/qemu-api/src/uninit.rs
diff options
context:
space:
mode:
Diffstat (limited to 'rust/qemu-api/src/uninit.rs')
-rw-r--r--rust/qemu-api/src/uninit.rs85
1 files changed, 0 insertions, 85 deletions
diff --git a/rust/qemu-api/src/uninit.rs b/rust/qemu-api/src/uninit.rs
deleted file mode 100644
index 04123b4ae9..0000000000
--- a/rust/qemu-api/src/uninit.rs
+++ /dev/null
@@ -1,85 +0,0 @@
-//! Access fields of a [`MaybeUninit`]
-
-use std::{
-    mem::MaybeUninit,
-    ops::{Deref, DerefMut},
-};
-
-pub struct MaybeUninitField<'a, T, U> {
-    parent: &'a mut MaybeUninit<T>,
-    child: *mut U,
-}
-
-impl<'a, T, U> MaybeUninitField<'a, T, U> {
-    #[doc(hidden)]
-    pub fn new(parent: &'a mut MaybeUninit<T>, child: *mut U) -> Self {
-        MaybeUninitField { parent, child }
-    }
-
-    /// Return a constant pointer to the containing object of the field.
-    ///
-    /// Because the `MaybeUninitField` remembers the containing object,
-    /// it is possible to use it in foreign APIs that initialize the
-    /// child.
-    pub fn parent(f: &Self) -> *const T {
-        f.parent.as_ptr()
-    }
-
-    /// Return a mutable pointer to the containing object.
-    ///
-    /// Because the `MaybeUninitField` remembers the containing object,
-    /// it is possible to use it in foreign APIs that initialize the
-    /// child.
-    pub fn parent_mut(f: &mut Self) -> *mut T {
-        f.parent.as_mut_ptr()
-    }
-}
-
-impl<'a, T, U> Deref for MaybeUninitField<'a, T, U> {
-    type Target = MaybeUninit<U>;
-
-    fn deref(&self) -> &MaybeUninit<U> {
-        // SAFETY: self.child was obtained by dereferencing a valid mutable
-        // reference; the content of the memory may be invalid or uninitialized
-        // but MaybeUninit<_> makes no assumption on it
-        unsafe { &*(self.child.cast()) }
-    }
-}
-
-impl<'a, T, U> DerefMut for MaybeUninitField<'a, T, U> {
-    fn deref_mut(&mut self) -> &mut MaybeUninit<U> {
-        // SAFETY: self.child was obtained by dereferencing a valid mutable
-        // reference; the content of the memory may be invalid or uninitialized
-        // but MaybeUninit<_> makes no assumption on it
-        unsafe { &mut *(self.child.cast()) }
-    }
-}
-
-/// ```
-/// #[derive(Debug)]
-/// struct S {
-///     x: u32,
-///     y: u32,
-/// }
-///
-/// # use std::mem::MaybeUninit;
-/// # use qemu_api::{assert_match, uninit_field_mut};
-///
-/// let mut s: MaybeUninit<S> = MaybeUninit::zeroed();
-/// uninit_field_mut!(s, x).write(5);
-/// let s = unsafe { s.assume_init() };
-/// assert_match!(s, S { x: 5, y: 0 });
-/// ```
-#[macro_export]
-macro_rules! uninit_field_mut {
-    ($container:expr, $($field:tt)+) => {{
-        let container__: &mut ::std::mem::MaybeUninit<_> = &mut $container;
-        let container_ptr__ = container__.as_mut_ptr();
-
-        // SAFETY: the container is not used directly, only through a MaybeUninit<>,
-        // so the safety is delegated to the caller and to final invocation of
-        // assume_init()
-        let target__ = unsafe { std::ptr::addr_of_mut!((*container_ptr__).$($field)+) };
-        $crate::uninit::MaybeUninitField::new(container__, target__)
-    }};
-}