pub struct I32<O>(/* private fields */);
Expand description
A 32-bit signed integer stored in a given byte order.
I32
is like the native i32
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
.
An I32
can be constructed using
the new
method, and its contained value can be obtained as a native
i32
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 I32
has endianness O
and that, b) the layout of i32
has
the platform’s native endianness.
I32
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> I32<O>
impl<O> I32<O>
Sourcepub const ZERO: I32<O>
pub const ZERO: I32<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 fn from_bytes(bytes: [u8; 4]) -> I32<O>
pub const fn from_bytes(bytes: [u8; 4]) -> I32<O>
Constructs a new value from bytes which are already in O
byte
order.
Source§impl<O: ByteOrder> I32<O>
impl<O: ByteOrder> I32<O>
Sourcepub const fn new(n: i32) -> I32<O>
pub const fn new(n: i32) -> I32<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<I32<O>> for i32
impl<O: ByteOrder> AddAssign<I32<O>> for i32
Source§fn add_assign(&mut self, rhs: I32<O>)
fn add_assign(&mut self, rhs: I32<O>)
+=
operation. Read moreSource§impl<O: ByteOrder> AddAssign<i32> for I32<O>
impl<O: ByteOrder> AddAssign<i32> for I32<O>
Source§fn add_assign(&mut self, rhs: i32)
fn add_assign(&mut self, rhs: i32)
+=
operation. Read moreSource§impl<O: ByteOrder> AddAssign for I32<O>
impl<O: ByteOrder> AddAssign for I32<O>
Source§fn add_assign(&mut self, rhs: I32<O>)
fn add_assign(&mut self, rhs: I32<O>)
+=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<I32<O>> for i32
impl<O: ByteOrder> BitAndAssign<I32<O>> for i32
Source§fn bitand_assign(&mut self, rhs: I32<O>)
fn bitand_assign(&mut self, rhs: I32<O>)
&=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<i32> for I32<O>
impl<O: ByteOrder> BitAndAssign<i32> for I32<O>
Source§fn bitand_assign(&mut self, rhs: i32)
fn bitand_assign(&mut self, rhs: i32)
&=
operation. Read moreSource§impl<O: ByteOrder> BitAndAssign for I32<O>
impl<O: ByteOrder> BitAndAssign for I32<O>
Source§fn bitand_assign(&mut self, rhs: I32<O>)
fn bitand_assign(&mut self, rhs: I32<O>)
&=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<I32<O>> for i32
impl<O: ByteOrder> BitOrAssign<I32<O>> for i32
Source§fn bitor_assign(&mut self, rhs: I32<O>)
fn bitor_assign(&mut self, rhs: I32<O>)
|=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<i32> for I32<O>
impl<O: ByteOrder> BitOrAssign<i32> for I32<O>
Source§fn bitor_assign(&mut self, rhs: i32)
fn bitor_assign(&mut self, rhs: i32)
|=
operation. Read moreSource§impl<O: ByteOrder> BitOrAssign for I32<O>
impl<O: ByteOrder> BitOrAssign for I32<O>
Source§fn bitor_assign(&mut self, rhs: I32<O>)
fn bitor_assign(&mut self, rhs: I32<O>)
|=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<I32<O>> for i32
impl<O: ByteOrder> BitXorAssign<I32<O>> for i32
Source§fn bitxor_assign(&mut self, rhs: I32<O>)
fn bitxor_assign(&mut self, rhs: I32<O>)
^=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<i32> for I32<O>
impl<O: ByteOrder> BitXorAssign<i32> for I32<O>
Source§fn bitxor_assign(&mut self, rhs: i32)
fn bitxor_assign(&mut self, rhs: i32)
^=
operation. Read moreSource§impl<O: ByteOrder> BitXorAssign for I32<O>
impl<O: ByteOrder> BitXorAssign for I32<O>
Source§fn bitxor_assign(&mut self, rhs: I32<O>)
fn bitxor_assign(&mut self, rhs: I32<O>)
^=
operation. Read moreSource§impl<O: ByteOrder> DivAssign<I32<O>> for i32
impl<O: ByteOrder> DivAssign<I32<O>> for i32
Source§fn div_assign(&mut self, rhs: I32<O>)
fn div_assign(&mut self, rhs: I32<O>)
/=
operation. Read moreSource§impl<O: ByteOrder> DivAssign<i32> for I32<O>
impl<O: ByteOrder> DivAssign<i32> for I32<O>
Source§fn div_assign(&mut self, rhs: i32)
fn div_assign(&mut self, rhs: i32)
/=
operation. Read moreSource§impl<O: ByteOrder> DivAssign for I32<O>
impl<O: ByteOrder> DivAssign for I32<O>
Source§fn div_assign(&mut self, rhs: I32<O>)
fn div_assign(&mut self, rhs: I32<O>)
/=
operation. Read moreSource§impl<O> FromBytes for I32<O>
impl<O> FromBytes for I32<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§impl<O> IntoBytes for I32<O>
impl<O> IntoBytes for I32<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§impl<O> KnownLayout for I32<O>
impl<O> KnownLayout for I32<O>
Source§type PointerMetadata = ()
type PointerMetadata = ()
Self
. Read moreSource§impl<O: ByteOrder> MulAssign<I32<O>> for i32
impl<O: ByteOrder> MulAssign<I32<O>> for i32
Source§fn mul_assign(&mut self, rhs: I32<O>)
fn mul_assign(&mut self, rhs: I32<O>)
*=
operation. Read moreSource§impl<O: ByteOrder> MulAssign<i32> for I32<O>
impl<O: ByteOrder> MulAssign<i32> for I32<O>
Source§fn mul_assign(&mut self, rhs: i32)
fn mul_assign(&mut self, rhs: i32)
*=
operation. Read moreSource§impl<O: ByteOrder> MulAssign for I32<O>
impl<O: ByteOrder> MulAssign for I32<O>
Source§fn mul_assign(&mut self, rhs: I32<O>)
fn mul_assign(&mut self, rhs: I32<O>)
*=
operation. Read moreSource§impl<O: ByteOrder> Ord for I32<O>
impl<O: ByteOrder> Ord for I32<O>
Source§impl<O: ByteOrder> PartialOrd<i32> for I32<O>
impl<O: ByteOrder> PartialOrd<i32> for I32<O>
Source§impl<O: ByteOrder> PartialOrd for I32<O>
impl<O: ByteOrder> PartialOrd for I32<O>
Source§impl<O: ByteOrder> RemAssign<I32<O>> for i32
impl<O: ByteOrder> RemAssign<I32<O>> for i32
Source§fn rem_assign(&mut self, rhs: I32<O>)
fn rem_assign(&mut self, rhs: I32<O>)
%=
operation. Read moreSource§impl<O: ByteOrder> RemAssign<i32> for I32<O>
impl<O: ByteOrder> RemAssign<i32> for I32<O>
Source§fn rem_assign(&mut self, rhs: i32)
fn rem_assign(&mut self, rhs: i32)
%=
operation. Read moreSource§impl<O: ByteOrder> RemAssign for I32<O>
impl<O: ByteOrder> RemAssign for I32<O>
Source§fn rem_assign(&mut self, rhs: I32<O>)
fn rem_assign(&mut self, rhs: I32<O>)
%=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign<I32<O>> for i32
impl<O: ByteOrder> ShlAssign<I32<O>> for i32
Source§fn shl_assign(&mut self, rhs: I32<O>)
fn shl_assign(&mut self, rhs: I32<O>)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign<i32> for I32<O>
impl<O: ByteOrder> ShlAssign<i32> for I32<O>
Source§fn shl_assign(&mut self, rhs: i32)
fn shl_assign(&mut self, rhs: i32)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShlAssign for I32<O>
impl<O: ByteOrder> ShlAssign for I32<O>
Source§fn shl_assign(&mut self, rhs: I32<O>)
fn shl_assign(&mut self, rhs: I32<O>)
<<=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign<I32<O>> for i32
impl<O: ByteOrder> ShrAssign<I32<O>> for i32
Source§fn shr_assign(&mut self, rhs: I32<O>)
fn shr_assign(&mut self, rhs: I32<O>)
>>=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign<i32> for I32<O>
impl<O: ByteOrder> ShrAssign<i32> for I32<O>
Source§fn shr_assign(&mut self, rhs: i32)
fn shr_assign(&mut self, rhs: i32)
>>=
operation. Read moreSource§impl<O: ByteOrder> ShrAssign for I32<O>
impl<O: ByteOrder> ShrAssign for I32<O>
Source§fn shr_assign(&mut self, rhs: I32<O>)
fn shr_assign(&mut self, rhs: I32<O>)
>>=
operation. Read moreSource§impl<O: ByteOrder> SubAssign<I32<O>> for i32
impl<O: ByteOrder> SubAssign<I32<O>> for i32
Source§fn sub_assign(&mut self, rhs: I32<O>)
fn sub_assign(&mut self, rhs: I32<O>)
-=
operation. Read moreSource§impl<O: ByteOrder> SubAssign<i32> for I32<O>
impl<O: ByteOrder> SubAssign<i32> for I32<O>
Source§fn sub_assign(&mut self, rhs: i32)
fn sub_assign(&mut self, rhs: i32)
-=
operation. Read moreSource§impl<O: ByteOrder> SubAssign for I32<O>
impl<O: ByteOrder> SubAssign for I32<O>
Source§fn sub_assign(&mut self, rhs: I32<O>)
fn sub_assign(&mut self, rhs: I32<O>)
-=
operation. Read moreSource§impl<O> TryFromBytes for I32<O>
impl<O> TryFromBytes for I32<O>
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 + IntoBytes,
fn try_mut_from_bytes(
bytes: &mut [u8],
) -> Result<&mut Self, TryCastError<&mut [u8], Self>>where
Self: KnownLayout + IntoBytes,
Source§fn try_mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), TryCastError<&mut [u8], Self>>where
Self: KnownLayout + IntoBytes,
fn try_mut_from_prefix(
source: &mut [u8],
) -> Result<(&mut Self, &mut [u8]), TryCastError<&mut [u8], Self>>where
Self: KnownLayout + IntoBytes,
Source§fn try_mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), TryCastError<&mut [u8], Self>>where
Self: KnownLayout + IntoBytes,
fn try_mut_from_suffix(
source: &mut [u8],
) -> Result<(&mut [u8], &mut Self), TryCastError<&mut [u8], Self>>where
Self: KnownLayout + IntoBytes,
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 I32<O>
impl<O: Eq> Eq for I32<O>
impl<O> Immutable for I32<O>
impl<O> StructuralPartialEq for I32<O>
impl<O> Unaligned for I32<O>
Auto Trait Implementations§
impl<O> Freeze for I32<O>
impl<O> RefUnwindSafe for I32<O>where
O: RefUnwindSafe,
impl<O> Send for I32<O>where
O: Send,
impl<O> Sync for I32<O>where
O: Sync,
impl<O> Unpin for I32<O>where
O: Unpin,
impl<O> UnwindSafe for I32<O>where
O: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Layout§
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...)
attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.
Size: 4 bytes