Enum BudgetedStringError 

pub enum BudgetedStringError<R, E, Q = u64>
where
    R: Debug,
    E: Debug + Display,
    Q: Copy + Debug,
{
    Budget(InsufficientBudgetError<R, Q>),
    Allocation(TryReserveError),
    Quantity {
        resource: R,
        source: QuantityConversionError,
    },
    Render(E),
    InvalidUtf8(FromUtf8Error),
    LengthOverflow,
}

Describes why a budgeted string rendering transaction failed.

Type Parameters

• R - Caller-defined resource identity retained by limits and errors.
• E - Error type returned by the caller-provided renderer.
• Q - Exact unsigned quantity used for measurements and accounting.

Examples

use qubit_budget::BudgetedStringError;

let error = BudgetedStringError::<&str, &str>::Render("render failed");
assert!(matches!(error, BudgetedStringError::Render("render failed")));

Variants

Budget(InsufficientBudgetError<R, Q>)

The rendered prefix exceeded the remaining resource budget.

Tuple Fields

0: InsufficientBudgetError<R, Q>

Exact resource, capacity, balance, and rejected request.

Allocation(TryReserveError)

The output buffer could not reserve the requested capacity.

Tuple Fields

0: TryReserveError

Allocation failure returned by the output byte buffer.

Quantity

The rendered UTF-8 byte length cannot be represented by the budget quantity.

Fields

resource: R

Resource whose accounting required the conversion.

source: QuantityConversionError

Failed quantity conversion.

Render(E)

The renderer returned an error unrelated to the budget writer.

Tuple Fields

0: E

Original error returned by the caller-provided renderer.

InvalidUtf8(FromUtf8Error)

The renderer produced bytes that are not valid UTF-8.

Tuple Fields

0: FromUtf8Error

UTF-8 conversion failure retaining the rendered bytes.

LengthOverflow

The rendered byte length overflowed usize.

Trait Implementations

impl<R, E, Q> Debug for BudgetedStringError<R, E, Q>

where R: Debug + Debug, E: Debug + Display + Debug, Q: Copy + Debug + Debug,

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

Formats the value using the given formatter.

impl<R, E, Q> Display for BudgetedStringError<R, E, Q>

where R: Debug, E: Debug + Display + Display, Q: Copy + Debug, InsufficientBudgetError<R, Q>: Display,

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

Formats the value using the given formatter.

impl<R, E, Q> Error for BudgetedStringError<R, E, Q>

where R: Debug, E: Debug + Display, Q: Copy + Debug, InsufficientBudgetError<R, Q>: Error, Self: Debug + Display,

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.