1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

#![cfg_attr(feature = "better-docs",
    feature(doc_cfg, decl_macro),
    cfg_attr(all(), doc = include_str!("../README.md")),
)]
//!
#![cfg_attr(feature = "specialization", feature(specialization))]
#![cfg_attr(feature = "specialization", allow(incomplete_features))]
#![allow(unused_attributes)]
#![deny(
    elided_lifetimes_in_paths,
    missing_docs,
    missing_copy_implementations,
    missing_debug_implementations,
    unsafe_op_in_unsafe_fn,
    unused_must_use
)]
#![no_std]

#[doc(hidden)]
pub use ::core;

pub use as_maybe_uninit::AsMaybeUninit;

#[cfg(feature = "alloc")]
#[doc(hidden)]
/// Not part of the public API
pub extern crate alloc;

#[cfg(feature = "std")]
#[doc(hidden)]
/// Not part of the public API
pub extern crate std;

#[macro_use]
mod utils;
pub mod prelude {
    //! Reexports of pervasive items.
    #[doc(no_inline)]
    pub use crate::{
        extension_traits::{AsOut, ManuallyDropMut},
        out_ref::Out,
        uninit_array,
    };
    cfg_alloc! {
        #[doc(no_inline)]
        pub use crate::extension_traits::{
            BoxAssumeInit,
            BoxNewUninitSlice,
            BoxUninit,
            VecCapacity,
        };
    }
    pub use ::core::mem::MaybeUninit;
}

use_prelude!();

mod as_maybe_uninit;
pub mod extension_traits;
#[cfg(feature = "std")]
#[cfg_attr(feature = "nightly", doc(cfg(feature = "std")))]
pub mod read;

pub mod out_ref;

/// Sets up an inline / stack-allocated array of
/// [uninitialized][`MaybeUninit`] elements.
///
/// # Example
///
/// ```rust
/// use ::uninit::{prelude::*, read::ReadIntoUninit};
///
/// let mut reader = &b"Hello, World!"[..];
/// let mut backing_array = uninit_array![u8; 4]; // : [MaybeUninit<u8>; 4]
/// let buf = backing_array.as_out();
/// assert_eq!(
///     reader.read_into_uninit_exact(buf).unwrap(),
///     b"Hell",
/// );
/// ```
#[macro_export]
macro_rules! uninit_array {
    (
    $T:ty ; $count:expr
) => {{
        use $crate::core::mem::MaybeUninit;
        const __UNINIT_ARRAY_COUNT__: usize = $count;
        unsafe {
            // # Safety
            //
            //   - `mem::uninitialized::<[MaybeUninit<_>; _]>()` is sound.
            MaybeUninit::<[MaybeUninit<$T>; __UNINIT_ARRAY_COUNT__]>::uninit().assume_init()
        }
    }};
}