Enum FoundationError 

pub enum FoundationError {
    InvalidHwpUnit {
        value: i64,
        min: i32,
        max: i32,
    },
    InvalidColor {
        component: String,
        value: String,
    },
    IndexOutOfBounds {
        index: usize,
        max: usize,
        type_name: &'static str,
    },
    EmptyIdentifier {
        item: String,
    },
    InvalidField {
        field: String,
        reason: String,
    },
    ParseError {
        type_name: String,
        value: String,
        valid_values: String,
    },
}

The primary error type for the Foundation crate.

Returned by constructors and validators when input violates constraints. Every variant carries enough context to produce a meaningful diagnostic message.

Examples

use hwpforge_foundation::FoundationError;

let err = FoundationError::InvalidHwpUnit {
    value: 999_999_999,
    min: -100_000_000,
    max: 100_000_000,
};
assert!(err.to_string().contains("999999999"));

Variants

InvalidHwpUnit

An HwpUnit value was outside the valid range.

Fields

value: i64

The rejected value (as i64 to avoid truncation in error messages).

min: i32

Minimum allowed value.

max: i32

Maximum allowed value.

InvalidColor

A Color value or component was invalid.

Fields

component: String

Which component failed (e.g. “red”, “raw”).

value: String

The rejected value.

IndexOutOfBounds

A branded index exceeded the collection bounds.

Fields

index: usize

The rejected index value.

max: usize

The upper bound (exclusive).

type_name: &'static str

The phantom type name for diagnostics.

EmptyIdentifier

A string identifier was empty.

Fields

item: String

What kind of identifier (e.g. “FontId”, “TemplateName”).

InvalidField

A generic field validation failure.

Fields

field: String

The field that failed validation.

reason: String

Why validation failed.

ParseError

A string could not be parsed into the target enum.

Fields

type_name: String

The target type name (e.g. “Alignment”).

value: String

The rejected input string.

valid_values: String

Comma-separated list of valid values.

Trait Implementations

impl Clone for FoundationError

fn clone(&self) -> FoundationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FoundationError

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

Formats the value using the given formatter.

impl Display for FoundationError

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

Formats the value using the given formatter.

impl Error for FoundationError

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.

impl ErrorCodeExt for FoundationError

fn code(&self) -> ErrorCode

Returns the numeric error code for this error.