oct 0.29.2

// Copyright 2024-2026 Gabriel Bjørnager Jensen.
//
// SPDX: MIT OR Apache-2.0

//! The [`FromOcts`] trait.

mod test;

use crate::{Immutable, Zeroable};

use core::cell::{Cell, UnsafeCell};
use core::cmp::Reverse;
use core::marker::{PhantomData, PhantomPinned};
use core::mem::{ManuallyDrop, MaybeUninit};
use core::num::{NonZero, Saturating, Wrapping};
use core::ptr::NonNull;
use core::slice;

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
use core::arch::aarch64::{
	float64x1_t,
	float64x1x2_t,
	float64x1x3_t,
	float64x1x4_t,
	float64x2_t,
	float64x2x2_t,
	float64x2x3_t,
	float64x2x4_t,
};

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
use core::arch::aarch64::{
	float32x2_t,
	float32x2x2_t,
	float32x2x3_t,
	float32x2x4_t,
	float32x4_t,
	float32x4x2_t,
	float32x4x3_t,
	float32x4x4_t,
	int16x4_t,
	int16x4x2_t,
	int16x4x3_t,
	int16x4x4_t,
	int16x8_t,
	int16x8x2_t,
	int16x8x3_t,
	int16x8x4_t,
	int32x2_t,
	int32x2x2_t,
	int32x2x3_t,
	int32x2x4_t,
	int32x4_t,
	int32x4x2_t,
	int32x4x3_t,
	int32x4x4_t,
	int64x1_t,
	int64x1x2_t,
	int64x1x3_t,
	int64x1x4_t,
	int64x2_t,
	int64x2x2_t,
	int64x2x3_t,
	int64x2x4_t,
	int8x16_t,
	int8x16x2_t,
	int8x16x3_t,
	int8x16x4_t,
	int8x8_t,
	int8x8x2_t,
	int8x8x3_t,
	int8x8x4_t,
	poly16x4_t,
	poly16x4x2_t,
	poly16x4x3_t,
	poly16x4x4_t,
	poly16x8_t,
	poly16x8x2_t,
	poly16x8x3_t,
	poly16x8x4_t,
	poly32x2_t,
	poly32x2x2_t,
	poly32x2x3_t,
	poly32x2x4_t,
	poly32x4_t,
	poly32x4x2_t,
	poly32x4x3_t,
	poly32x4x4_t,
	poly64x1_t,
	poly64x1x2_t,
	poly64x1x3_t,
	poly64x1x4_t,
	poly64x2_t,
	poly64x2x2_t,
	poly64x2x3_t,
	poly64x2x4_t,
	poly8x16_t,
	poly8x16x2_t,
	poly8x16x3_t,
	poly8x16x4_t,
	poly8x8_t,
	poly8x8x2_t,
	poly8x8x3_t,
	poly8x8x4_t,
	uint16x4_t,
	uint16x4x2_t,
	uint16x4x3_t,
	uint16x4x4_t,
	uint16x8_t,
	uint16x8x2_t,
	uint16x8x3_t,
	uint16x8x4_t,
	uint32x2_t,
	uint32x2x2_t,
	uint32x2x3_t,
	uint32x2x4_t,
	uint32x4_t,
	uint32x4x2_t,
	uint32x4x3_t,
	uint32x4x4_t,
	uint64x1_t,
	uint64x1x2_t,
	uint64x1x3_t,
	uint64x1x4_t,
	uint64x2_t,
	uint64x2x2_t,
	uint64x2x3_t,
	uint64x2x4_t,
	uint8x16_t,
	uint8x16x2_t,
	uint8x16x3_t,
	uint8x16x4_t,
	uint8x8_t,
	uint8x8x2_t,
	uint8x8x3_t,
	uint8x8x4_t,
};

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
use core::arch::aarch64::{
	float16x4_t,
	float16x4x2_t,
	float16x4x3_t,
	float16x4x4_t,
	float16x8_t,
	float16x8x2_t,
	float16x8x3_t,
	float16x8x4_t,
};

#[cfg(target_has_atomic = "128")]
use core::sync::atomic::{AtomicI128, AtomicU128};

#[cfg(target_has_atomic = "16")]
use core::sync::atomic::{AtomicI16, AtomicU16};

#[cfg(target_has_atomic = "32")]
use core::sync::atomic::{AtomicI32, AtomicU32};

#[cfg(target_has_atomic = "64")]
use core::sync::atomic::{AtomicI64, AtomicU64};

#[cfg(target_has_atomic = "8")]
use core::sync::atomic::{AtomicI8, AtomicU8};

#[cfg(target_has_atomic = "ptr")]
use core::sync::atomic::{AtomicIsize, AtomicUsize};

#[cfg(target_arch = "x86")]
use core::arch::x86::{
	__m128,
	__m128bh,
	__m128d,
	__m128i,
	__m256,
	__m256bh,
	__m256d,
	__m256i,
	__m512,
	__m512bh,
	__m512d,
	__m512i,
};

#[cfg(all(target_arch = "x86", feature = "f16", ))]
use core::arch::x86::{__m128h, __m256h, __m512h};

#[cfg(target_arch = "x86_64")]
use core::arch::x86_64::{
	__m128,
	__m128bh,
	__m128d,
	__m128i,
	__m256,
	__m256bh,
	__m256d,
	__m256i,
	__m512,
	__m512bh,
	__m512d,
	__m512i,
};

#[cfg(all(target_arch = "x86_64", feature = "f16", ))]
use core::arch::x86_64::{__m128h, __m256h, __m512h};

/// Denotes a type that can represent all octets
/// (bytes).
///
/// # Pointers
///
/// This type isn't implemented for pointers as any
/// pointer constructed from such octets would be
/// without provenance -- even if the address itself
/// is valid. We do therefore not implement this
/// trait for any pointer type as we see it to be
/// too confusing.
///
/// Pointers do, however, implement [`Zeroable`], as
/// such behaviour cannot be confused in the same
/// way. Similarly, pointers also implement
/// [`IntoOcts`] as that alone can't lead to any
/// undefined behaviour.
///
/// [`IntoOcts`]: crate::IntoOcts
///
/// Note that this decision may be overtuned in the
/// future.
///
/// # `MaybeUninit`
///
/// Whilst [`MaybeUninit<T>`] does implement this
/// trait for any type `T`, such implementation
/// alone makes no guarantees about the validity of
/// calls to [`assume_init`]; such still depends on
/// whether or not the provided representation is
/// valid for the given instance of `T`. Where
/// `T: FromOcts` applies, this is always valid.
///
/// [`assume_init`]: MaybeUninit::assume_init
///
/// # Safety
///
/// Types that implement this trait must be
/// represent from any permutation of [`u8`]
/// patterns. Furthermore, any such representation
/// must constitute an initialised state of the type
/// in question (by extension, this prohibits
/// uninhabited types from implementing this trait).
///
/// The provided functions of this trait may not be
/// overriden.
pub unsafe trait FromOcts: Zeroable {
	/// Reads an object from octets.
	///
	/// The returned object is considered initialised.
	///
	/// # Panics
	///
	/// This constructor will panic if the provided
	/// octets are unaligned for `Self` or their length
	/// is less than the size of `Size`.
	#[inline(always)]
	#[must_use]
	#[track_caller]
	fn read_from_octs(octs: &[u8]) -> Self
	where
		Self: Sized,
	{
		assert!(
			octs.len() >= size_of::<Self>(),
			"cannot read object from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing object,
		// which implies that object being initialised. We
		// have asserted that the octets are of a suffi-
		// cient size.
		let p = octs.as_ptr().cast::<Self>();

		assert!(
			p.is_aligned(),
			"cannot read object from unaligned octets",
		);

		// SAFETY: The pointer is derived from a reference,
		// and we have asserted that it is aligned.
		unsafe { p.read() }
	}

	/// Reads an object from octets.
	///
	/// The returned object is considered initialised.
	///
	/// # Panics
	///
	/// If the length of the provided octets is less
	/// than the size of `Self`, this constructor will
	/// panic.
	#[inline(always)]
	#[must_use]
	#[track_caller]
	fn read_from_octs_unaligned(octs: &[u8]) -> Self
	where
		Self: Sized,
	{
		assert!(
			octs.len() >= size_of::<Self>(),
			"cannot read object from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing object,
		// which implies that object being initialised. We
		// have asserted that the octets are of a suffi-
		// cient size.
		let p = octs.as_ptr().cast::<Self>();

		// SAFETY: The pointer is derived from a reference,
		// and we make sure to use an unaligned read.
		unsafe { p.read_unaligned() }
	}

	/// Reinterprets octets as a constant reference.
	///
	/// The referenced object is considered initialised.
	///
	/// # Panics
	///
	/// If the length of the provided octets is less
	/// than the size of `Self` or the octets themselves
	/// are unaligned, this constructor will panic.
	#[inline]
	#[must_use]
	#[track_caller]
	fn ref_from_octs(octs: &[u8]) -> &Self
	where
		Self: Sized + Immutable,
	{
		assert!(
			octs.len() >= size_of::<Self>(),
			"cannot construct reference from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing type.
		let p = octs.as_ptr().cast::<Self>();

		assert!(
			p.is_aligned(),
			"cannot construct reference from unaligned octets",
		);

		// SAFETY: We have tested that the octets are both
		// sized properly and aligned. `Immutable` guaran-
		// tees that the returned reference cannot be used
		// to modify the original octets.
		unsafe { &*p }
	}

	// NOTE: No need to require `Immutable` as writes
	// are always allowed.
	/// Reinterprets octets as a mutable reference.
	///
	/// The referenced object is considered initialised.
	///
	/// # Panics
	///
	/// If the length of the provided octets is less
	/// than the size of `Self` or the octets themselves
	/// are unaligned, this constructor will panic.
	#[inline]
	#[must_use]
	#[track_caller]
	fn mut_from_octs(octs: &mut [u8]) -> &mut Self
	where
		Self: Sized,
	{
		assert!(
			octs.len() >= size_of::<Self>(),
			"cannot construct reference from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing type.
		let p = octs.as_mut_ptr().cast::<Self>();

		assert!(
			p.is_aligned(),
			"cannot construct reference from unaligned octets",
		);

		// SAFETY: We have tested that the octets are both
		// sized properly and aligned. Furthermore, given
		// that it derives from a mutable reference, we can
		// guarantee that it is also exclusive.
		unsafe { &mut *p }
	}

	/// Reinterprets octets as a constant slice.
	///
	/// The referenced objects are considered
	/// initialised.
	///
	/// # Panics
	///
	/// If the length of the provided octets is less
	/// than the size of `[Self; len]` or the octets
	/// themselves are unaligned, this constructor will
	/// panic.
	#[inline]
	#[must_use]
	#[track_caller]
	fn slice_from_octs(octs: &[u8], len: usize) -> &[Self]
	where
		Self: Sized + Immutable,
	{
		let size = size_of::<Self>() * len;

		assert!(
			octs.len() >= size,
			"cannot construct slice from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing type.
		let data = octs.as_ptr().cast::<Self>();

		assert!(
			data.is_aligned(),
			"cannot construct slice from unaligned octets",
		);

		// SAFETY: We have tested that the octets are both
		// sized properly and aligned. `Immutable` guaran-
		// tees that the returned slice cannot be used to
		// modify the original octets.
		unsafe { slice::from_raw_parts(data, len) }
	}

	// NOTE: No need to require `Immutable` as writes
	// are always allowed.
	/// Reinterprets octets as a mutable slice.
	///
	/// The referenced objects are considered
	/// initialised.
	///
	/// # Panics
	///
	/// If the length of the provided octets is less
	/// than the size of `[Self; len]` or the octets
	/// themselves are unaligned, this constructor will
	/// panic.
	#[inline]
	#[must_use]
	#[track_caller]
	fn slice_from_octs_mut(octs: &mut [u8], len: usize) -> &mut [Self]
	where
		Self: Sized,
	{
		let size = size_of::<Self>() * len;

		assert!(
			octs.len() >= size,
			"cannot construct slice from undersized octets",
		);

		// SAFETY: Implementers guarantee that we may rein-
		// terpret such octets as the implementing type.
		let data = octs.as_mut_ptr().cast::<Self>();

		assert!(
			data.is_aligned(),
			"cannot construct slice from unaligned octets",
		);

		// SAFETY: We have tested that the octets are both
		// sized properly and aligned. Furthermore, given
		// that it derives from a mutable reference, we can
		// guarantee that it is also exclusive.
		unsafe { slice::from_raw_parts_mut(data, len) }
	}

	/// Constructs a new object from all-ones.
	///
	/// The returned object is considered initialised.
	#[inline]
	#[must_use]
	fn oned() -> Self
	where
		Self: Sized,
	{
		let mut this = MaybeUninit::<Self>::uninit();
		this.make_oned();

		// SAFETY: `make_oned` guarantees an initialised
		// state.
		unsafe { this.assume_init() }
	}

	/// Overwrites the object with all-ones.
	///
	/// The provided object is considered initialised
	/// after a successful call to this method.
	#[inline]
	fn make_oned(&mut self) {
		let len = size_of_val(self);
		let ptr = (&raw mut *self).cast::<u8>();

		// SAFETY `size_of_val` guarantees the exact size
		// of the referenced object. Implementing this
		// trait additionally guarantees that an all-ones
		// representation is valid.
		unsafe { ptr.write_bytes(0b11111111, len) };
	}
}

// SORT: array
unsafe impl<T: FromOcts, const N: usize> FromOcts for [T; N] {}

// SAFETY: `AtomicI128` is transparent to `i128`.
#[cfg(target_has_atomic = "128")]
unsafe impl FromOcts for AtomicI128 {}

// SAFETY: `AtomicI16` is transparent to `i16`.
#[cfg(target_has_atomic = "16")]
unsafe impl FromOcts for AtomicI16 {}

// SAFETY: `AtomicI32` is transparent to `i32`.
#[cfg(target_has_atomic = "32")]
unsafe impl FromOcts for AtomicI32 {}

// SAFETY: `AtomicI64` is transparent to `i64`.
#[cfg(target_has_atomic = "64")]
unsafe impl FromOcts for AtomicI64 {}

// SAFETY: `AtomicI8` is transparent to `i8`.
#[cfg(target_has_atomic = "8")]
unsafe impl FromOcts for AtomicI8 {}

// SAFETY: `AtomicIsize` is transparent to `isize`.
#[cfg(target_has_atomic = "ptr")]
unsafe impl FromOcts for AtomicIsize {}

// SAFETY: `AtomicU128` is transparent to `u128`.
#[cfg(target_has_atomic = "128")]
unsafe impl FromOcts for AtomicU128 {}

// SAFETY: `AtomicU16` is transparent to `u16`.
#[cfg(target_has_atomic = "16")]
unsafe impl FromOcts for AtomicU16 {}

// SAFETY: `AtomicU32` is transparent to `u32`.
#[cfg(target_has_atomic = "32")]
unsafe impl FromOcts for AtomicU32 {}

// SAFETY: `AtomicU64` is transparent to `u64`.
#[cfg(target_has_atomic = "64")]
unsafe impl FromOcts for AtomicU64 {}

// SAFETY: `AtomicU8` is transparent to `u8`.
#[cfg(target_has_atomic = "8")]
unsafe impl FromOcts for AtomicU8 {}

// SAFETY: `AtomicUsize` is transparent to `usize`.
#[cfg(target_has_atomic = "ptr")]
unsafe impl FromOcts for AtomicUsize {}

// SAFETY: `Cell<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for Cell<T> {}

#[cfg(feature = "f128")]
unsafe impl FromOcts for f128 {}

#[cfg(feature = "f16")]
unsafe impl FromOcts for f16 {}

unsafe impl FromOcts for f32 {}

unsafe impl FromOcts for f64 {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x4_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x4x2_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x4x3_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x4x4_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x8_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x8x2_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x8x3_t {}

#[cfg(
	all(
		any(
			target_arch = "aarch64",
			target_arch = "arm64ec",
			target_feature = "v7",
		),
		feature = "f16",
	),
)]
unsafe impl FromOcts for float16x8x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x2x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for float32x4x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x1_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x1x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x1x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x1x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec"))]
unsafe impl FromOcts for float64x2x4_t {}

unsafe impl FromOcts for i128 {}

unsafe impl FromOcts for i16 {}

unsafe impl FromOcts for i32 {}

unsafe impl FromOcts for i64 {}

unsafe impl FromOcts for i8 {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x4x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int16x8x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x2x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int32x4x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x1_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x1x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x1x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x1x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int64x2x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x16_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x16x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x16x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x16x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for int8x8x4_t {}

unsafe impl FromOcts for isize {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m128 {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m128 {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m128bh {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m128bh {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m128d {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m128d {}

#[cfg(all(target_arch = "x86", feature = "f16", ))]
unsafe impl FromOcts for __m128h {}

#[cfg(all(target_arch = "x86_64", feature = "f16", ))]
unsafe impl FromOcts for __m128h {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m128i {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m128i {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m256 {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m256 {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m256bh {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m256bh {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m256d {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m256d {}

#[cfg(all(target_arch = "x86", feature = "f16", ))]
unsafe impl FromOcts for __m256h {}

#[cfg(all(target_arch = "x86_64", feature = "f16", ))]
unsafe impl FromOcts for __m256h {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m256i {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m256i {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m512 {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m512 {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m512bh {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m512bh {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m512d {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m512d {}

#[cfg(all(target_arch = "x86", feature = "f16", ))]
unsafe impl FromOcts for __m512h {}

#[cfg(all(target_arch = "x86_64", feature = "f16", ))]
unsafe impl FromOcts for __m512h {}

#[cfg(target_arch = "x86")]
unsafe impl FromOcts for __m512i {}

#[cfg(target_arch = "x86_64")]
unsafe impl FromOcts for __m512i {}

// SAFETY: `ManuallyDrop<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for ManuallyDrop<T> {}

// SAFETY: `MaybeUninit<T>` supports any represen-
// tation.
unsafe impl<T> FromOcts for MaybeUninit<T> {}

// // SORT: never
// unsafe impl FromOcts for ! {}

// FIXME: Require `T: Thin` instead of `T: Sized`.
// SAFETY: `Option<NonNull<T>>` is transparent to
// to `Option<NonZero<usize>>` when `T: Sized`.
unsafe impl<T> FromOcts for Option<NonNull<T>> {}

// SAFETY: `Option<NonZero<i128>>` is transparent
// to `i128`.
unsafe impl FromOcts for Option<NonZero<i128>> {}

// SAFETY: `Option<NonZero<i16>>` is transparent to
// `i16`.
unsafe impl FromOcts for Option<NonZero<i16>> {}

// SAFETY: `Option<NonZero<i32>>` is transparent to
// `i32`.
unsafe impl FromOcts for Option<NonZero<i32>> {}

// SAFETY: `Option<NonZero<i64>>` is transparent to
// `i64`.
unsafe impl FromOcts for Option<NonZero<i64>> {}

// SAFETY: `Option<NonZero<i8>>` is transparent to
// `i8`.
unsafe impl FromOcts for Option<NonZero<i8>> {}

// SAFETY: `Option<NonZero<isize>>` is transparent
// to `isize`.
unsafe impl FromOcts for Option<NonZero<isize>> {}

// SAFETY: `Option<NonZero<u128>>` is transparent
// to `u128`.
unsafe impl FromOcts for Option<NonZero<u128>> {}

// SAFETY: `Option<NonZero<u16>>` is transparent to
// `u16`.
unsafe impl FromOcts for Option<NonZero<u16>> {}

// SAFETY: `Option<NonZero<u32>>` is transparent to
// `u32`.
unsafe impl FromOcts for Option<NonZero<u32>> {}

// SAFETY: `Option<NonZero<u64>>` is transparent to
// `u64`.
unsafe impl FromOcts for Option<NonZero<u64>> {}

// SAFETY: `Option<NonZero<u8>>` is transparent to
// `u8`.
unsafe impl FromOcts for Option<NonZero<u8>> {}

// SAFETY: `Option<NonZero<usize>>` is transparent
// to `usize`.
unsafe impl FromOcts for Option<NonZero<usize>> {}

// SAFETY: `PhantomData<T>` is a ZST.
unsafe impl<T: ?Sized> FromOcts for PhantomData<T> {}

// SAFETY: `PhantomPinned` is a ZST.
unsafe impl FromOcts for PhantomPinned {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x4x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly16x8x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x2x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly32x4x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x1_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x1x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x1x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x1x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly64x2x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x16_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x16x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x16x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x16x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for poly8x8x4_t {}

// SAFETY `Reverse<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for Reverse<T> {}

// SAFETY: `Saturating<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for Saturating<T> {}

// SORT: slice
// SAFETY: Slices have the same representation as
// arrays.
unsafe impl<T: FromOcts> FromOcts for [T] {}

unsafe impl FromOcts for str {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
/// Implemented for tuples with up to twelve
/// members.
#[cfg_attr(feature = "unstable_docs", doc(fake_variadic))]
unsafe impl<T: FromOcts> FromOcts for (T,) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T, T, T, T, T) {}

// SORT: tuple
// SAFETY: Homogeneous tuples have the same repre-
// sentation as arrays.
#[doc(hidden)]
unsafe impl<T: FromOcts> FromOcts for (T, T, T, T, T, T, T, T, T, T, T, T) {}

unsafe impl FromOcts for u128 {}

unsafe impl FromOcts for u16 {}

unsafe impl FromOcts for u32 {}

unsafe impl FromOcts for u64 {}

unsafe impl FromOcts for u8 {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x4x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint16x8x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x2x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x4_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x4x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x4x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint32x4x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x1_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x1x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x1x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x1x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x2x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x2x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint64x2x4t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x16_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x16x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x16x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x16x_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x8_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x8x2_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x8x3_t {}

#[cfg(any(target_arch = "aarch64", target_arch = "arm64ec", target_feature = "v7"))]
unsafe impl FromOcts for uint8x8x4_t {}

// SORT: unit
unsafe impl FromOcts for () {}

// SAFETY: `UnsafeCell<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for UnsafeCell<T> {}

unsafe impl FromOcts for usize {}

// SAFETY: `Wrapping<T>` is transparent to `T`.
unsafe impl<T: FromOcts> FromOcts for Wrapping<T> {}