pub struct Isize<O>(/* private fields */);Expand description
A word-sized signed integer stored in a given byte order.
Isize is like the native isize 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 Isize can be constructed using
the new method, and its contained value can be obtained as a native
isize 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 Isize
has endianness O and that, b) the layout of isize has
the platform’s native endianness.
Isize 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> Isize<O>
impl<O> Isize<O>
Sourcepub const ZERO: Isize<O>
pub const ZERO: Isize<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]) -> Isize<O>
pub const fn from_bytes(bytes: [u8; 4]) -> Isize<O>
Constructs a new value from bytes which are already in O byte
order.
Source§impl<O: ByteOrder> Isize<O>
impl<O: ByteOrder> Isize<O>
Sourcepub const fn new(n: isize) -> Isize<O>
Available on non-no_zerocopy_generic_bounds_in_const_fn_1_61_0 only.
pub const fn new(n: isize) -> Isize<O>
no_zerocopy_generic_bounds_in_const_fn_1_61_0 only.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 for Isize<O>
impl<O: ByteOrder> AddAssign for Isize<O>
Source§fn add_assign(&mut self, rhs: Isize<O>)
fn add_assign(&mut self, rhs: Isize<O>)
+= operation. Read moreSource§impl<O: ByteOrder> AddAssign<Isize<O>> for isize
impl<O: ByteOrder> AddAssign<Isize<O>> for isize
Source§fn add_assign(&mut self, rhs: Isize<O>)
fn add_assign(&mut self, rhs: Isize<O>)
+= operation. Read moreSource§impl<O: ByteOrder> AddAssign<isize> for Isize<O>
impl<O: ByteOrder> AddAssign<isize> for Isize<O>
Source§fn add_assign(&mut self, rhs: isize)
fn add_assign(&mut self, rhs: isize)
+= operation. Read moreSource§impl<O: ByteOrder> BitAndAssign for Isize<O>
impl<O: ByteOrder> BitAndAssign for Isize<O>
Source§fn bitand_assign(&mut self, rhs: Isize<O>)
fn bitand_assign(&mut self, rhs: Isize<O>)
&= operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<Isize<O>> for isize
impl<O: ByteOrder> BitAndAssign<Isize<O>> for isize
Source§fn bitand_assign(&mut self, rhs: Isize<O>)
fn bitand_assign(&mut self, rhs: Isize<O>)
&= operation. Read moreSource§impl<O: ByteOrder> BitAndAssign<isize> for Isize<O>
impl<O: ByteOrder> BitAndAssign<isize> for Isize<O>
Source§fn bitand_assign(&mut self, rhs: isize)
fn bitand_assign(&mut self, rhs: isize)
&= operation. Read moreSource§impl<O: ByteOrder> BitOrAssign for Isize<O>
impl<O: ByteOrder> BitOrAssign for Isize<O>
Source§fn bitor_assign(&mut self, rhs: Isize<O>)
fn bitor_assign(&mut self, rhs: Isize<O>)
|= operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<Isize<O>> for isize
impl<O: ByteOrder> BitOrAssign<Isize<O>> for isize
Source§fn bitor_assign(&mut self, rhs: Isize<O>)
fn bitor_assign(&mut self, rhs: Isize<O>)
|= operation. Read moreSource§impl<O: ByteOrder> BitOrAssign<isize> for Isize<O>
impl<O: ByteOrder> BitOrAssign<isize> for Isize<O>
Source§fn bitor_assign(&mut self, rhs: isize)
fn bitor_assign(&mut self, rhs: isize)
|= operation. Read moreSource§impl<O: ByteOrder> BitXorAssign for Isize<O>
impl<O: ByteOrder> BitXorAssign for Isize<O>
Source§fn bitxor_assign(&mut self, rhs: Isize<O>)
fn bitxor_assign(&mut self, rhs: Isize<O>)
^= operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<Isize<O>> for isize
impl<O: ByteOrder> BitXorAssign<Isize<O>> for isize
Source§fn bitxor_assign(&mut self, rhs: Isize<O>)
fn bitxor_assign(&mut self, rhs: Isize<O>)
^= operation. Read moreSource§impl<O: ByteOrder> BitXorAssign<isize> for Isize<O>
impl<O: ByteOrder> BitXorAssign<isize> for Isize<O>
Source§fn bitxor_assign(&mut self, rhs: isize)
fn bitxor_assign(&mut self, rhs: isize)
^= operation. Read moreimpl<O: Copy> Copy for Isize<O>
Source§impl<O: ByteOrder> DivAssign for Isize<O>
impl<O: ByteOrder> DivAssign for Isize<O>
Source§fn div_assign(&mut self, rhs: Isize<O>)
fn div_assign(&mut self, rhs: Isize<O>)
/= operation. Read moreSource§impl<O: ByteOrder> DivAssign<Isize<O>> for isize
impl<O: ByteOrder> DivAssign<Isize<O>> for isize
Source§fn div_assign(&mut self, rhs: Isize<O>)
fn div_assign(&mut self, rhs: Isize<O>)
/= operation. Read moreSource§impl<O: ByteOrder> DivAssign<isize> for Isize<O>
impl<O: ByteOrder> DivAssign<isize> for Isize<O>
Source§fn div_assign(&mut self, rhs: isize)
fn div_assign(&mut self, rhs: isize)
/= operation. Read moreimpl<O: Eq> Eq for Isize<O>
Source§impl<O> FromBytes for Isize<O>
Available on crate features derive only.
impl<O> FromBytes for Isize<O>
derive only.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 Isize<O>
Available on crate features derive only.
impl<O> FromZeros for Isize<O>
derive only.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. Read moreimpl<O> Immutable for Isize<O>
derive only.Source§impl<O> IntoBytes for Isize<O>
Available on crate features derive only.
impl<O> IntoBytes for Isize<O>
derive only.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 Isize<O>where
Self: Sized,
Available on crate features derive only.
impl<O> KnownLayout for Isize<O>where
Self: Sized,
derive only.Source§type PointerMetadata = ()
type PointerMetadata = ()
Self. Read moreSource§fn size_for_metadata(meta: Self::PointerMetadata) -> Option<usize>
fn size_for_metadata(meta: Self::PointerMetadata) -> Option<usize>
Self with the given pointer
metadata. Read moreSource§impl<O: ByteOrder> MulAssign for Isize<O>
impl<O: ByteOrder> MulAssign for Isize<O>
Source§fn mul_assign(&mut self, rhs: Isize<O>)
fn mul_assign(&mut self, rhs: Isize<O>)
*= operation. Read moreSource§impl<O: ByteOrder> MulAssign<Isize<O>> for isize
impl<O: ByteOrder> MulAssign<Isize<O>> for isize
Source§fn mul_assign(&mut self, rhs: Isize<O>)
fn mul_assign(&mut self, rhs: Isize<O>)
*= operation. Read moreSource§impl<O: ByteOrder> MulAssign<isize> for Isize<O>
impl<O: ByteOrder> MulAssign<isize> for Isize<O>
Source§fn mul_assign(&mut self, rhs: isize)
fn mul_assign(&mut self, rhs: isize)
*= operation. Read moreSource§impl<O: ByteOrder> Ord for Isize<O>
impl<O: ByteOrder> Ord for Isize<O>
1.21.0 (const: unstable) · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl<O: ByteOrder> PartialOrd for Isize<O>
impl<O: ByteOrder> PartialOrd for Isize<O>
Source§impl<O: ByteOrder> PartialOrd<isize> for Isize<O>
impl<O: ByteOrder> PartialOrd<isize> for Isize<O>
Source§impl<O: ByteOrder> RemAssign for Isize<O>
impl<O: ByteOrder> RemAssign for Isize<O>
Source§fn rem_assign(&mut self, rhs: Isize<O>)
fn rem_assign(&mut self, rhs: Isize<O>)
%= operation. Read moreSource§impl<O: ByteOrder> RemAssign<Isize<O>> for isize
impl<O: ByteOrder> RemAssign<Isize<O>> for isize
Source§fn rem_assign(&mut self, rhs: Isize<O>)
fn rem_assign(&mut self, rhs: Isize<O>)
%= operation. Read moreSource§impl<O: ByteOrder> RemAssign<isize> for Isize<O>
impl<O: ByteOrder> RemAssign<isize> for Isize<O>
Source§fn rem_assign(&mut self, rhs: isize)
fn rem_assign(&mut self, rhs: isize)
%= operation. Read moreSource§impl<O: ByteOrder> ShlAssign for Isize<O>
impl<O: ByteOrder> ShlAssign for Isize<O>
Source§fn shl_assign(&mut self, rhs: Isize<O>)
fn shl_assign(&mut self, rhs: Isize<O>)
<<= operation. Read moreSource§impl<O: ByteOrder> ShlAssign<Isize<O>> for isize
impl<O: ByteOrder> ShlAssign<Isize<O>> for isize
Source§fn shl_assign(&mut self, rhs: Isize<O>)
fn shl_assign(&mut self, rhs: Isize<O>)
<<= operation. Read moreSource§impl<O: ByteOrder> ShlAssign<isize> for Isize<O>
impl<O: ByteOrder> ShlAssign<isize> for Isize<O>
Source§fn shl_assign(&mut self, rhs: isize)
fn shl_assign(&mut self, rhs: isize)
<<= operation. Read moreSource§impl<O: ByteOrder> ShrAssign for Isize<O>
impl<O: ByteOrder> ShrAssign for Isize<O>
Source§fn shr_assign(&mut self, rhs: Isize<O>)
fn shr_assign(&mut self, rhs: Isize<O>)
>>= operation. Read moreSource§impl<O: ByteOrder> ShrAssign<Isize<O>> for isize
impl<O: ByteOrder> ShrAssign<Isize<O>> for isize
Source§fn shr_assign(&mut self, rhs: Isize<O>)
fn shr_assign(&mut self, rhs: Isize<O>)
>>= operation. Read moreSource§impl<O: ByteOrder> ShrAssign<isize> for Isize<O>
impl<O: ByteOrder> ShrAssign<isize> for Isize<O>
Source§fn shr_assign(&mut self, rhs: isize)
fn shr_assign(&mut self, rhs: isize)
>>= operation. Read moreimpl<O: PartialEq> StructuralPartialEq for Isize<O>
Source§impl<O: ByteOrder> SubAssign for Isize<O>
impl<O: ByteOrder> SubAssign for Isize<O>
Source§fn sub_assign(&mut self, rhs: Isize<O>)
fn sub_assign(&mut self, rhs: Isize<O>)
-= operation. Read moreSource§impl<O: ByteOrder> SubAssign<Isize<O>> for isize
impl<O: ByteOrder> SubAssign<Isize<O>> for isize
Source§fn sub_assign(&mut self, rhs: Isize<O>)
fn sub_assign(&mut self, rhs: Isize<O>)
-= operation. Read moreSource§impl<O: ByteOrder> SubAssign<isize> for Isize<O>
impl<O: ByteOrder> SubAssign<isize> for Isize<O>
Source§fn sub_assign(&mut self, rhs: isize)
fn sub_assign(&mut self, rhs: isize)
-= operation. Read moreSource§impl<O> TryFromBytes for Isize<O>
Available on crate features derive only.
impl<O> TryFromBytes for Isize<O>
derive only.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> Unaligned for Isize<O>
derive only.