Struct RawException 

pub struct RawException { /* private fields */ }

An exception caught and detached from the call scratch: the payload is copied once, into storage owned by the value itself, so it survives arbitrary later SDK operations (including re-use of the call scratch). Without alloc that storage is a fixed SCRATCH_MAX-capacity inline buffer, so the value (and any error enum holding it) is roughly 4 KiB; under alloc it is an exact-size heap allocation. Use MapExceptions when a compact classification is enough and the original wire bytes do not need to outlive the call.

Deliberately not encodable: there is no WriteXDR impl. re_throw aborts with the verbatim wire bytes; try_as decodes to a typed exception, with selector / payload for raw inspection.

Implementations

impl RawException

pub fn selector(&self) -> u64

pub fn payload(&self) -> &[u8]

The exception payload (everything after the selector prefix).

pub fn try_as<T: Exn + ReadXDROwned>(&self) -> Option<T>

pub fn try_decode<T: Exn + ReadXDROwned>(&self) -> Option<Result<T, ReadError>>

See RawExceptionRef::try_decode.

pub fn re_throw(&self) -> !

Re-throw to our caller with the original wire bytes, verbatim.

pub fn new(selector: u64, payload: &[u8]) -> Self

Build from a selector and payload. Test/mock construction.

pub fn from_abort_buf(bytes: &[u8]) -> Result<Self, LibraryExn>

Parse an abort wire buffer ([CXS(selector)][payload]) into an owned exception. Host tests and mock plumbing.

Trait Implementations

impl Debug for RawException

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<RawExceptionRef<'_>> for RawException

What RawExceptionRef::to_owned produces: one copy. Any number may be live at once; without alloc each value carries its own fixed SCRATCH_MAX-capacity buffer.

fn from(exn: RawExceptionRef<'_>) -> Self

Converts to this type from the input type.

impl MatchExn for RawException

fn as_exn(&self) -> Option<RawExceptionRef<'_>>

The caught exception, or None if this failure carries none (a fault, an invalid call, an encode/decode failure).

fn try_as<E: Exn + ReadXDROwned>(&self) -> Option<E>

Decode as E if this failure carries an exception of that type.

fn try_decode<E: Exn + ReadXDROwned>(&self) -> Option<Result<E, ReadError>>

try_as with the decode failure kept separate:

impl PartialEq for RawException

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl ReThrow for RawException

fn re_throw(self) -> !

Re-throw this error. Exceptions are propagated as exceptions; faults panic (a fault stays a fault).