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§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§impl<O> FromZeros for I32<O>
impl<O> FromZeros for I32<O>
Source§fn new_zeroed() -> Selfwhere
Self: Sized,
fn new_zeroed() -> Selfwhere
Self: Sized,
Self
from zeroed bytes. Read moreSource§fn new_box_zeroed() -> Result<Box<Self>, AllocError>where
Self: Sized,
fn new_box_zeroed() -> Result<Box<Self>, AllocError>where
Self: Sized,
alloc
only.Box<Self>
from zeroed bytes. Read moreSource§fn new_vec_zeroed(len: usize) -> Result<Vec<Self>, AllocError>where
Self: Sized,
fn new_vec_zeroed(len: usize) -> Result<Vec<Self>, AllocError>where
Self: Sized,
alloc
only.Vec<Self>
from zeroed bytes. Read moreSource§fn extend_vec_zeroed(
v: &mut Vec<Self>,
additional: usize,
) -> Result<(), AllocError>where
Self: Sized,
fn extend_vec_zeroed(
v: &mut Vec<Self>,
additional: usize,
) -> Result<(), AllocError>where
Self: Sized,
rust="1.57.0"
and crate feature alloc
only.Vec<Self>
by pushing additional
new items onto the end of
the vector. The new items are initialized with zeros.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§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 I32<O>where
Self: Sized,
impl<O> KnownLayout for I32<O>where
Self: Sized,
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 more