pub type CastError<Src, Dst: ?Sized> = ConvertError<AlignmentError<Src, Dst>, SizeError<Src, Dst>, Infallible>;
Expand description
The error type of reference conversions.
Reference conversions, like FromBytes::ref_from_bytes
may emit
alignment and size errors.
Aliased Type§
enum CastError<Src, Dst: ?Sized> {
Alignment(AlignmentError<Src, Dst>),
Size(SizeError<Src, Dst>),
Validity(Infallible),
}
Variants§
Alignment(AlignmentError<Src, Dst>)
The conversion source was improperly aligned.
Size(SizeError<Src, Dst>)
The conversion source was of incorrect size.
Validity(Infallible)
The conversion source contained invalid data.
Implementations§
Source§impl<Src, Dst: ?Sized> CastError<Src, Dst>
impl<Src, Dst: ?Sized> CastError<Src, Dst>
Sourcepub fn map_src<NewSrc>(
self,
f: impl FnOnce(Src) -> NewSrc,
) -> CastError<NewSrc, Dst>
pub fn map_src<NewSrc>( self, f: impl FnOnce(Src) -> NewSrc, ) -> CastError<NewSrc, Dst>
Maps the source value associated with the conversion error.
This can help mitigate issues with Send
, Sync
and 'static
bounds.
§Examples
use zerocopy::*;
let source: [u8; 3] = [0, 1, 2];
// Try to read a `u32` from `source`. This will fail because there are insufficient
// bytes in `source`.
let maybe_u32: Result<&u32, CastError<&[u8], u32>> = u32::ref_from_bytes(&source[..]);
// Map the error's source to its size and address.
let maybe_u32: Result<&u32, CastError<(usize, usize), u32>> = maybe_u32.map_err(|err| {
err.map_src(|src| (src.len(), src.as_ptr() as usize))
});
Trait Implementations
Source§impl<A: Display, S: Display, V: Display> Display for ConvertError<A, S, V>
Produces a human-readable error message.
impl<A: Display, S: Display, V: Display> Display for ConvertError<A, S, V>
Produces a human-readable error message.
The message differs between debug and release builds. When
debug_assertions
are enabled, this message is verbose and includes
potentially sensitive information.
Source§impl<A, S, V> Error for ConvertError<A, S, V>
impl<A, S, V> Error for ConvertError<A, S, V>
1.30.0 · Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
👎Deprecated since 1.42.0: use the Display impl or to_string()
Source§impl<Src, Dst: ?Sized, S, V> From<AlignmentError<Src, Dst>> for ConvertError<AlignmentError<Src, Dst>, S, V>
impl<Src, Dst: ?Sized, S, V> From<AlignmentError<Src, Dst>> for ConvertError<AlignmentError<Src, Dst>, S, V>
Source§fn from(err: AlignmentError<Src, Dst>) -> Self
fn from(err: AlignmentError<Src, Dst>) -> Self
Converts to this type from the input type.