pub struct U32<O>(/* private fields */);
Expand description
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§
Source§impl<O> U32<O>
impl<O> U32<O>
Sourcepub const ZERO: U32<O> = _
pub const ZERO: U32<O> = _
The value zero.
This constant should be preferred to constructing a new value
using new
, as new
may perform an endianness swap depending
on the endianness and platform.
Sourcepub const MAX_VALUE: U32<O> = _
pub const MAX_VALUE: U32<O> = _
The maximum value.
This constant should be preferred to constructing a new value using
new
, as new
may perform an endianness swap depending on the
endianness O
and the endianness of the platform.
Sourcepub const fn from_bytes(bytes: [u8; 4]) -> U32<O>
pub const fn from_bytes(bytes: [u8; 4]) -> U32<O>
Constructs a new value from bytes which are already in O
byte
order.
Source§impl<O: ByteOrder> U32<O>
impl<O: ByteOrder> U32<O>
Sourcepub const fn new(n: u32) -> U32<O>
pub 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
.
Trait Implementations§
Source§impl<O: ByteOrder> AddAssign<U32<O>> for u32
impl<O: ByteOrder> AddAssign<U32<O>> for u32
Source§fn add_assign(&mut self, rhs: U32<O>)
fn add_assign(&mut self, rhs: U32<O>)
+=
operation. Read moreSource§impl<O: ByteOrder> AddAssign<u32> for U32<O>
impl<O: ByteOrder> AddAssign<u32> for U32<O>
Source§fn add_assign(&mut self, rhs: u32)
fn add_assign(&mut self, rhs: u32)
+=
operation. Read moreSource§impl<O: ByteOrder> AddAssign for U32<O>
impl<O: ByteOrder> AddAssign for U32<O>
Source§fn add_assign(&mut self, rhs: U32<O>)
fn add_assign(&mut self, rhs: U32<O>)
+=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<U32<O>> for u32
impl<O: ByteOrder> BitAndAssign<U32<O>> for u32
Source§fn bitand_assign(&mut self, rhs: U32<O>)
fn bitand_assign(&mut self, rhs: U32<O>)
&=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<u32> for U32<O>
impl<O: ByteOrder> BitAndAssign<u32> for U32<O>
Source§fn bitand_assign(&mut self, rhs: u32)
fn bitand_assign(&mut self, rhs: u32)
&=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign for U32<O>
impl<O: ByteOrder> BitAndAssign for U32<O>
Source§fn bitand_assign(&mut self, rhs: U32<O>)
fn bitand_assign(&mut self, rhs: U32<O>)
&=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<U32<O>> for u32
impl<O: ByteOrder> BitOrAssign<U32<O>> for u32
Source§fn bitor_assign(&mut self, rhs: U32<O>)
fn bitor_assign(&mut self, rhs: U32<O>)
|=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<u32> for U32<O>
impl<O: ByteOrder> BitOrAssign<u32> for U32<O>
Source§fn bitor_assign(&mut self, rhs: u32)
fn bitor_assign(&mut self, rhs: u32)
|=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign for U32<O>
impl<O: ByteOrder> BitOrAssign for U32<O>
Source§fn bitor_assign(&mut self, rhs: U32<O>)
fn bitor_assign(&mut self, rhs: U32<O>)
|=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<U32<O>> for u32
impl<O: ByteOrder> BitXorAssign<U32<O>> for u32
Source§fn bitxor_assign(&mut self, rhs: U32<O>)
fn bitxor_assign(&mut self, rhs: U32<O>)
^=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<u32> for U32<O>
impl<O: ByteOrder> BitXorAssign<u32> for U32<O>
Source§fn bitxor_assign(&mut self, rhs: u32)
fn bitxor_assign(&mut self, rhs: u32)
^=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign for U32<O>
impl<O: ByteOrder> BitXorAssign for U32<O>
Source§fn bitxor_assign(&mut self, rhs: U32<O>)
fn bitxor_assign(&mut self, rhs: U32<O>)
^=
operation. Read moreSource§impl<O: ByteOrder> DivAssign<U32<O>> for u32
impl<O: ByteOrder> DivAssign<U32<O>> for u32
Source§fn div_assign(&mut self, rhs: U32<O>)
fn div_assign(&mut self, rhs: U32<O>)
/=
operation. Read moreSource§impl<O: ByteOrder> DivAssign<u32> for U32<O>
impl<O: ByteOrder> DivAssign<u32> for U32<O>
Source§fn div_assign(&mut self, rhs: u32)
fn div_assign(&mut self, rhs: u32)
/=
operation. Read moreSource§impl<O: ByteOrder> DivAssign for U32<O>
impl<O: ByteOrder> DivAssign for U32<O>
Source§fn div_assign(&mut self, rhs: U32<O>)
fn div_assign(&mut self, rhs: U32<O>)
/=
operation. Read moreSource§impl<O> FromBytes for U32<O>
impl<O> FromBytes for U32<O>
Source§fn ref_from_bytes(source: &[u8]) -> Result<&Self, CastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
fn ref_from_bytes(source: &[u8]) -> Result<&Self, CastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
Source§fn ref_from_prefix(
source: &[u8],
) -> Result<(&Self, &[u8]), CastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
fn ref_from_prefix(
source: &[u8],
) -> Result<(&Self, &[u8]), CastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
Source§fn ref_from_suffix(
source: &[u8],
) -> Result<(&[u8], &Self), CastError<&[u8], Self>>where
Self: Immutable + KnownLayout,
fn ref_from_suffix(
source: &[u8],
) -> Result<(&[u8], &Self), CastError<&[u8], Self>>where
Self: Immutable + KnownLayout,
&Self
. Read moreSource§fn mut_from_bytes(
source: &mut [u8],
) -> Result<&mut Self, CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
fn mut_from_bytes(
source: &mut [u8],
) -> Result<&mut Self, CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
Source§fn mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
fn mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
Source§fn mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
fn mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), CastError<&mut [u8], Self>>where
Self: IntoBytes + KnownLayout,
Source§fn read_from_bytes(source: &[u8]) -> Result<Self, SizeError<&[u8], Self>>where
Self: Sized,
fn read_from_bytes(source: &[u8]) -> Result<Self, SizeError<&[u8], Self>>where
Self: Sized,
Source§fn read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), SizeError<&[u8], Self>>where
Self: Sized,
fn read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), SizeError<&[u8], Self>>where
Self: Sized,
Source§fn read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), SizeError<&[u8], Self>>where
Self: Sized,
fn read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), SizeError<&[u8], Self>>where
Self: Sized,
Source§impl<O> IntoBytes for U32<O>
impl<O> IntoBytes for U32<O>
Source§fn as_mut_bytes(&mut self) -> &mut [u8]where
Self: FromBytes,
fn as_mut_bytes(&mut self) -> &mut [u8]where
Self: FromBytes,
Source§fn write_to(&self, dst: &mut [u8]) -> Result<(), SizeError<&Self, &mut [u8]>>where
Self: Immutable,
fn write_to(&self, dst: &mut [u8]) -> Result<(), SizeError<&Self, &mut [u8]>>where
Self: Immutable,
Source§fn write_to_prefix(
&self,
dst: &mut [u8],
) -> Result<(), SizeError<&Self, &mut [u8]>>where
Self: Immutable,
fn write_to_prefix(
&self,
dst: &mut [u8],
) -> Result<(), SizeError<&Self, &mut [u8]>>where
Self: Immutable,
Source§impl<O> KnownLayout for U32<O>where
Self: Sized,
impl<O> KnownLayout for U32<O>where
Self: Sized,
Source§type PointerMetadata = ()
type PointerMetadata = ()
Self
. Read moreSource§impl<O: ByteOrder> MulAssign<U32<O>> for u32
impl<O: ByteOrder> MulAssign<U32<O>> for u32
Source§fn mul_assign(&mut self, rhs: U32<O>)
fn mul_assign(&mut self, rhs: U32<O>)
*=
operation. Read moreSource§impl<O: ByteOrder> MulAssign<u32> for U32<O>
impl<O: ByteOrder> MulAssign<u32> for U32<O>
Source§fn mul_assign(&mut self, rhs: u32)
fn mul_assign(&mut self, rhs: u32)
*=
operation. Read moreSource§impl<O: ByteOrder> MulAssign for U32<O>
impl<O: ByteOrder> MulAssign for U32<O>
Source§fn mul_assign(&mut self, rhs: U32<O>)
fn mul_assign(&mut self, rhs: U32<O>)
*=
operation. Read moreSource§impl<O: ByteOrder> Ord for U32<O>
impl<O: ByteOrder> Ord for U32<O>
Source§impl<O: ByteOrder> PartialOrd<u32> for U32<O>
impl<O: ByteOrder> PartialOrd<u32> for U32<O>
Source§impl<O: ByteOrder> PartialOrd for U32<O>
impl<O: ByteOrder> PartialOrd for U32<O>
Source§impl<O: ByteOrder> RemAssign<U32<O>> for u32
impl<O: ByteOrder> RemAssign<U32<O>> for u32
Source§fn rem_assign(&mut self, rhs: U32<O>)
fn rem_assign(&mut self, rhs: U32<O>)
%=
operation. Read moreSource§impl<O: ByteOrder> RemAssign<u32> for U32<O>
impl<O: ByteOrder> RemAssign<u32> for U32<O>
Source§fn rem_assign(&mut self, rhs: u32)
fn rem_assign(&mut self, rhs: u32)
%=
operation. Read moreSource§impl<O: ByteOrder> RemAssign for U32<O>
impl<O: ByteOrder> RemAssign for U32<O>
Source§fn rem_assign(&mut self, rhs: U32<O>)
fn rem_assign(&mut self, rhs: U32<O>)
%=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign<U32<O>> for u32
impl<O: ByteOrder> ShlAssign<U32<O>> for u32
Source§fn shl_assign(&mut self, rhs: U32<O>)
fn shl_assign(&mut self, rhs: U32<O>)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign<u32> for U32<O>
impl<O: ByteOrder> ShlAssign<u32> for U32<O>
Source§fn shl_assign(&mut self, rhs: u32)
fn shl_assign(&mut self, rhs: u32)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign for U32<O>
impl<O: ByteOrder> ShlAssign for U32<O>
Source§fn shl_assign(&mut self, rhs: U32<O>)
fn shl_assign(&mut self, rhs: U32<O>)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign<U32<O>> for u32
impl<O: ByteOrder> ShrAssign<U32<O>> for u32
Source§fn shr_assign(&mut self, rhs: U32<O>)
fn shr_assign(&mut self, rhs: U32<O>)
>>=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign<u32> for U32<O>
impl<O: ByteOrder> ShrAssign<u32> for U32<O>
Source§fn shr_assign(&mut self, rhs: u32)
fn shr_assign(&mut self, rhs: u32)
>>=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign for U32<O>
impl<O: ByteOrder> ShrAssign for U32<O>
Source§fn shr_assign(&mut self, rhs: U32<O>)
fn shr_assign(&mut self, rhs: U32<O>)
>>=
operation. Read moreSource§impl<O: ByteOrder> SubAssign<U32<O>> for u32
impl<O: ByteOrder> SubAssign<U32<O>> for u32
Source§fn sub_assign(&mut self, rhs: U32<O>)
fn sub_assign(&mut self, rhs: U32<O>)
-=
operation. Read moreSource§impl<O: ByteOrder> SubAssign<u32> for U32<O>
impl<O: ByteOrder> SubAssign<u32> for U32<O>
Source§fn sub_assign(&mut self, rhs: u32)
fn sub_assign(&mut self, rhs: u32)
-=
operation. Read moreSource§impl<O: ByteOrder> SubAssign for U32<O>
impl<O: ByteOrder> SubAssign for U32<O>
Source§fn sub_assign(&mut self, rhs: U32<O>)
fn sub_assign(&mut self, rhs: U32<O>)
-=
operation. Read moreSource§impl<O> TryFromBytes for U32<O>where
[u8; 4]: TryFromBytes,
PhantomData<O>: TryFromBytes,
impl<O> TryFromBytes for U32<O>where
[u8; 4]: TryFromBytes,
PhantomData<O>: TryFromBytes,
Source§fn try_ref_from_bytes(source: &[u8]) -> Result<&Self, TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
fn try_ref_from_bytes(source: &[u8]) -> Result<&Self, TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
Source§fn try_ref_from_prefix(
source: &[u8],
) -> Result<(&Self, &[u8]), TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
fn try_ref_from_prefix(
source: &[u8],
) -> Result<(&Self, &[u8]), TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
Source§fn try_ref_from_suffix(
source: &[u8],
) -> Result<(&[u8], &Self), TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
fn try_ref_from_suffix(
source: &[u8],
) -> Result<(&[u8], &Self), TryCastError<&[u8], Self>>where
Self: KnownLayout + Immutable,
Source§fn try_mut_from_bytes(
bytes: &mut [u8],
) -> Result<&mut Self, TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
fn try_mut_from_bytes(
bytes: &mut [u8],
) -> Result<&mut Self, TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
Source§fn try_mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
fn try_mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
Source§fn try_mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
fn try_mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), TryCastError<&mut [u8], Self>>where
Self: KnownLayout,
Source§fn try_read_from_bytes(source: &[u8]) -> Result<Self, TryReadError<&[u8], Self>>where
Self: Sized,
fn try_read_from_bytes(source: &[u8]) -> Result<Self, TryReadError<&[u8], Self>>where
Self: Sized,
Source§fn try_read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), TryReadError<&[u8], Self>>where
Self: Sized,
fn try_read_from_prefix(
source: &[u8],
) -> Result<(Self, &[u8]), TryReadError<&[u8], Self>>where
Self: Sized,
Source§fn try_read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), TryReadError<&[u8], Self>>where
Self: Sized,
fn try_read_from_suffix(
source: &[u8],
) -> Result<(&[u8], Self), TryReadError<&[u8], Self>>where
Self: Sized,
impl<O: Copy> Copy for U32<O>
impl<O: Eq> Eq for U32<O>
impl<O> Immutable for U32<O>
impl<O> StructuralPartialEq for U32<O>
impl<O> Unaligned for U32<O>
Auto Trait Implementations§
impl<O> Freeze for U32<O>
impl<O> RefUnwindSafe for U32<O>where
O: RefUnwindSafe,
impl<O> Send for U32<O>where
O: Send,
impl<O> Sync for U32<O>where
O: Sync,
impl<O> Unpin for U32<O>where
O: Unpin,
impl<O> UnwindSafe for U32<O>where
O: UnwindSafe,
Blanket Implementations§
§impl<T> Any for Twhere
T: 'static + ?Sized,
impl<T> Any for Twhere
T: 'static + ?Sized,
§impl<T> Borrow<T> for Twhere
T: ?Sized,
impl<T> Borrow<T> for Twhere
T: ?Sized,
§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)