Struct U32
#[repr(transparent)]
pub struct U32<O>(/* private field */, /* private field */);A 32-bit unsigned integer stored in a given byte order.
U32 is like the native u32 type with
two major differences: First, it has no alignment requirement (its alignment is 1).
Second, the endianness of its memory layout is given by the type parameter O,
which can be any type which implements ByteOrder. In particular, this refers
to BigEndian, LittleEndian, NativeEndian, and NetworkEndian.
A U32 can be constructed using
the new method, and its contained value can be obtained as a native
u32 using the get method, or updated in place with
the set method. In all cases, if the endianness O is not the same as the
endianness of the current platform, an endianness swap will be performed in
order to uphold the invariants that a) the layout of U32
has endianness O and that, b) the layout of u32 has
the platform's native endianness.
U32 implements FromBytes, IntoBytes, and Unaligned,
making it useful for parsing and serialization. See the module documentation for an
example of how it can be used for parsing UDP packets.
Implementations
impl<O> U32<O>
const ZERO: U32<O> = _;The value zero.
This constant should be preferred to constructing a new value using
new, asnewmay perform an endianness swap depending on the endianness and platform.const MAX_VALUE: U32<O> = _;The maximum value.
This constant should be preferred to constructing a new value using
new, asnewmay perform an endianness swap depending on the endiannessOand the endianness of the platform.const fn from_bytes(bytes: [u8; 4]) -> U32<O>Constructs a new value from bytes which are already in
Obyte order.const fn to_bytes(self) -> [u8; 4]Extracts the bytes of
selfwithout swapping the byte order.The returned bytes will be in
Obyte order.
impl<O: ByteOrder> U32<O>
const fn new(n: u32) -> U32<O>Constructs a new value, possibly performing an endianness swap to guarantee that the returned value has endianness
O.const fn get(self) -> u32Returns the value as a primitive type, possibly performing an endianness swap to guarantee that the return value has the endianness of the native platform.
fn set(&mut self, n: u32)Updates the value in place as a primitive type, possibly performing an endianness swap to guarantee that the stored value has the endianness
O.
Trait Implementations
impl<O> AsMut<[u8; 4]> for U32<O>
fn as_mut(&mut self) -> &mut [u8; 4]
impl<O> AsRef<[u8; 4]> for U32<O>
fn as_ref(&self) -> &[u8; 4]
impl<O> Default for U32<O>
fn default() -> U32<O>
impl<O> FromBytes for U32<O>
where
[u8; 4]: FromBytes,
PhantomData<O>: FromBytes,
impl<O> FromZeros for U32<O>
where
[u8; 4]: FromZeros,
PhantomData<O>: FromZeros,
impl<O> Immutable for U32<O>
where
[u8; 4]: Immutable,
PhantomData<O>: Immutable,
impl<O> IntoBytes for U32<O>
where
[u8; 4]: IntoBytes,
PhantomData<O>: IntoBytes,
impl<O> KnownLayout for U32<O>
where
Self: Sized,
type PointerMetadata = ();
impl<O> Not for U32<O>
type Output = U32<O>;fn not(self) -> U32<O>
impl<O> PartialEq<[u8; 4]> for U32<O>
fn eq(&self, other: &[u8; 4]) -> bool
impl<O> TryFromBytes for U32<O>
where
[u8; 4]: TryFromBytes,
PhantomData<O>: TryFromBytes,
impl<O> Unaligned for U32<O>
where
[u8; 4]: Unaligned,
PhantomData<O>: Unaligned,
impl<O: ByteOrder> Add for U32<O>
type Output = U32<O>;fn add(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Add<u32> for U32<O>
type Output = U32<O>;fn add(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> AddAssign for U32<O>
fn add_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> AddAssign<u32> for U32<O>
fn add_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Binary for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder> BitAnd for U32<O>
type Output = U32<O>;fn bitand(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> BitAnd<u32> for U32<O>
type Output = U32<O>;fn bitand(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> BitAndAssign for U32<O>
fn bitand_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> BitAndAssign<u32> for U32<O>
fn bitand_assign(&mut self, rhs: u32)
impl<O: ByteOrder> BitOr for U32<O>
type Output = U32<O>;fn bitor(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> BitOr<u32> for U32<O>
type Output = U32<O>;fn bitor(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> BitOrAssign for U32<O>
fn bitor_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> BitOrAssign<u32> for U32<O>
fn bitor_assign(&mut self, rhs: u32)
impl<O: ByteOrder> BitXor for U32<O>
type Output = U32<O>;fn bitxor(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> BitXor<u32> for U32<O>
type Output = U32<O>;fn bitxor(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> BitXorAssign for U32<O>
fn bitxor_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> BitXorAssign<u32> for U32<O>
fn bitxor_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Debug for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder> Display for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder> Div for U32<O>
type Output = U32<O>;fn div(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Div<u32> for U32<O>
type Output = U32<O>;fn div(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> DivAssign for U32<O>
fn div_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> DivAssign<u32> for U32<O>
fn div_assign(&mut self, rhs: u32)
impl<O: ByteOrder> From<[u8; 4]> for U32<O>
fn from(bytes: [u8; 4]) -> U32<O>
impl<O: ByteOrder> From<u32> for U32<O>
fn from(x: u32) -> U32<O>
impl<O: ByteOrder> LowerHex for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder> Mul for U32<O>
type Output = U32<O>;fn mul(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Mul<u32> for U32<O>
type Output = U32<O>;fn mul(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> MulAssign for U32<O>
fn mul_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> MulAssign<u32> for U32<O>
fn mul_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Octal for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder> Ord for U32<O>
fn cmp(&self, other: &Self) -> Ordering
impl<O: ByteOrder> PartialEq<u32> for U32<O>
fn eq(&self, other: &u32) -> bool
impl<O: ByteOrder> PartialOrd for U32<O>
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
impl<O: ByteOrder> PartialOrd<u32> for U32<O>
fn partial_cmp(&self, other: &u32) -> Option<Ordering>
impl<O: ByteOrder> Rem for U32<O>
type Output = U32<O>;fn rem(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Rem<u32> for U32<O>
type Output = U32<O>;fn rem(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> RemAssign for U32<O>
fn rem_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> RemAssign<u32> for U32<O>
fn rem_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Shl for U32<O>
type Output = U32<O>;fn shl(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Shl<u32> for U32<O>
type Output = U32<O>;fn shl(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> ShlAssign for U32<O>
fn shl_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> ShlAssign<u32> for U32<O>
fn shl_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Shr for U32<O>
type Output = U32<O>;fn shr(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Shr<u32> for U32<O>
type Output = U32<O>;fn shr(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> ShrAssign for U32<O>
fn shr_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> ShrAssign<u32> for U32<O>
fn shr_assign(&mut self, rhs: u32)
impl<O: ByteOrder> Sub for U32<O>
type Output = U32<O>;fn sub(self, rhs: U32<O>) -> U32<O>
impl<O: ByteOrder> Sub<u32> for U32<O>
type Output = U32<O>;fn sub(self, rhs: u32) -> U32<O>
impl<O: ByteOrder> SubAssign for U32<O>
fn sub_assign(&mut self, rhs: U32<O>)
impl<O: ByteOrder> SubAssign<u32> for U32<O>
fn sub_assign(&mut self, rhs: u32)
impl<O: ByteOrder> TryFrom<u128> for U32<O>
type Error = TryFromIntError;fn try_from(x: u128) -> Result<U32<O>, TryFromIntError>
impl<O: ByteOrder> TryFrom<u64> for U32<O>
type Error = TryFromIntError;fn try_from(x: u64) -> Result<U32<O>, TryFromIntError>
impl<O: ByteOrder> UpperHex for U32<O>
fn fmt(&self, f: &mut Formatter<'_>) -> Result
impl<O: ByteOrder, P: ByteOrder> From<U16<O>> for U32<P>
fn from(x: U16<O>) -> U32<P>
impl<O: ByteOrder, P: ByteOrder> TryFrom<U128<P>> for U32<O>
type Error = TryFromIntError;fn try_from(x: U128<P>) -> Result<U32<O>, TryFromIntError>
impl<O: ByteOrder, P: ByteOrder> TryFrom<U64<P>> for U32<O>
type Error = TryFromIntError;fn try_from(x: U64<P>) -> Result<U32<O>, TryFromIntError>
impl<O: Clone> Clone for U32<O>
fn clone(&self) -> U32<O>
impl<O: Copy> Copy for U32<O>
impl<O: Eq> Eq for U32<O>
impl<O: Hash> Hash for U32<O>
fn hash<__H: Hasher>(&self, state: &mut __H)
impl<O: PartialEq> PartialEq for U32<O>
fn eq(&self, other: &U32<O>) -> bool
impl<O: PartialEq> StructuralPartialEq for U32<O>
Auto Trait Implementations
impl<O> Freeze for U32<O>
where
PhantomData<O>: Freeze,
impl<O> RefUnwindSafe for U32<O>
where
PhantomData<O>: RefUnwindSafe,
impl<O> Send for U32<O>
where
PhantomData<O>: Send,
impl<O> Sync for U32<O>
where
PhantomData<O>: Sync,
impl<O> Unpin for U32<O>
where
PhantomData<O>: Unpin,
impl<O> UnsafeUnpin for U32<O>
where
PhantomData<O>: UnsafeUnpin,
impl<O> UnwindSafe for U32<O>
where
PhantomData<O>: UnwindSafe,
Blanket Implementations
impl<T> Any for U32<O>
where
T: 'static + ?Sized,
fn type_id(&self) -> TypeId
impl<T> Borrow<T> for U32<O>
where
T: ?Sized,
fn borrow(&self) -> &T
impl<T> BorrowMut<T> for U32<O>
where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
impl<T> CloneToUninit for U32<O>
where
T: Clone,
unsafe fn clone_to_uninit(&self, dest: *mut u8)
impl<T> From<T> for U32<O>
fn from(t: T) -> TReturns the argument unchanged.
impl<T, U> Into<U> for U32<O>
where
U: From<T>,
fn into(self) -> UCalls
U::from(self).That is, this conversion is whatever the implementation of
[From]<T> for Uchooses to do.
impl<T, U> TryFrom<U> for U32<O>
where
U: Into<T>,
type Error = never;fn try_from(value: U) -> Result<T, never>
impl<T, U> TryInto<U> for U32<O>
where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error;fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>