Struct UnicodeErrorData 

pub struct UnicodeErrorData {
    pub encoding: String,
    pub object: UnicodeErrorObject,
    pub start: usize,
    pub end: usize,
    pub reason: String,
}

Structured fields of a UnicodeDecodeError / UnicodeEncodeError, mirroring CPython’s encoding / object / start / end / reason exception attributes.

Monty exceptions are otherwise message-only; unicode errors additionally carry these fields so host bindings (e.g. pydantic_monty) can construct real UnicodeDecodeError / UnicodeEncodeError instances instead of falling back to a plain ValueError. The payload is omitted when the offending object is larger than UnicodeErrorData::MAX_OBJECT_LEN — exceptions can be stored and copied outside the sandbox’s resource tracker, so an unbounded payload would let huge inputs evade memory limits. Sandboxed code never sees these fields (in-sandbox exceptions expose only args).

Fields

encoding: String

The codec name as CPython reports it, e.g. "utf-8", "ascii".

object: UnicodeErrorObject

The full input that failed to encode/decode (str for encode errors, bytes for decode errors), matching CPython’s exc.object.

start: usize

Start of the failing range: a character index for encode errors, a byte offset for decode errors.

end: usize

Exclusive end of the failing range, in the same units as start.

reason: String

CPython’s reason wording, e.g. "ordinal not in range(128)".

Implementations

impl UnicodeErrorData

pub const MAX_OBJECT_LEN: usize

Payload size cap: unicode errors on objects larger than this carry no structured data (hosts fall back to the message-only ValueError). Exception payloads are copied into the host once they escape the worker, so the cap bounds how much host memory a single raise can pin.

pub fn encode( encoding: &str, object: &str, start: usize, end: usize, reason: &str, ) -> ExcData

Builds the payload for an encode error on object, or ExcData::None when object exceeds Self::MAX_OBJECT_LEN.

pub fn decode( encoding: &str, object: &[u8], start: usize, end: usize, reason: &str, ) -> ExcData

Builds the payload for a decode error on object, or ExcData::None when object exceeds Self::MAX_OBJECT_LEN. Public so monty-fs can build the payload for text-mode file reads.

Trait Implementations

impl Clone for UnicodeErrorData

fn clone(&self) -> UnicodeErrorData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UnicodeErrorData

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UnicodeErrorData

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for UnicodeErrorData

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UnicodeErrorData

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for UnicodeErrorData

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UnicodeErrorData