Struct PerlError 

pub struct PerlError {
    pub kind: ErrorKind,
    pub message: String,
    pub line: usize,
    pub file: String,
    pub die_value: Option<PerlValue>,
    pub near: Option<String>,
}

Fields

kind: ErrorKind

message: String

line: usize

file: String

die_value: Option<PerlValue>

When die is called with a ref argument, the original value is preserved here so that $@ can hold the ref (not just its stringification).

near: Option<String>

For Syntax errors, optional suffix shown after at -e line N. Perl emits , near "TOKEN" or , at EOF depending on where the parse failed; absent (None) yields the standard period-terminated form.

Implementations

impl PerlError

pub fn new( kind: ErrorKind, message: impl Into<String>, line: usize, file: impl Into<String>, ) -> Self

pub fn with_near(self, near: impl Into<String>) -> Self

Attach a , near "..." or , at EOF suffix used by Perl’s compile-error formatter. Only takes effect for ErrorKind::Syntax.

pub fn syntax(message: impl Into<String>, line: usize) -> Self

pub fn runtime(message: impl Into<String>, line: usize) -> Self

pub fn type_error(message: impl Into<String>, line: usize) -> Self

pub fn at_line(self, line: usize) -> Self

Replace line number (e.g. map VM op line onto an error).

pub fn die(message: impl Into<String>, line: usize) -> Self

pub fn division_by_zero(message: impl Into<String>, line: usize) -> Self

Constructor for division-by-zero errors. The user-visible message and Display formatting are unchanged from runtime(...); only the kind differs, so callers (try/catch, error filters) can match ErrorKind::DivisionByZero specifically.

pub fn die_with_value(value: PerlValue, message: String, line: usize) -> Self

Trait Implementations

impl Clone for PerlError

fn clone(&self) -> PerlError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PerlError

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

Formats the value using the given formatter.

impl Display for PerlError

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

Formats the value using the given formatter.

impl Error for PerlError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.