Enum DataError 

pub enum DataError {
    SeriesNotFound {
        context: Option<ErrorContext>,
    },
    IndexOutOfBounds {
        context: Option<ErrorContext>,
    },
    InvalidDataPoint {
        context: Option<ErrorContext>,
    },
    ScalingError {
        context: Option<ErrorContext>,
    },
    BufferFull {
        context: Option<ErrorContext>,
    },
    InsufficientData {
        context: Option<ErrorContext>,
    },
}

Error type for data operations.

This error type covers all data-related operations including data series management, data point validation, and data processing operations.

Common Scenarios

• Adding data to a full buffer
• Accessing data with invalid indices
• Processing invalid data points
• Data scaling and transformation errors

Examples

use embedded_charts::prelude::*;
use embedded_charts::error::DataError;

let mut series = StaticDataSeries::<Point2D, 10>::new();

// Fill the series to capacity
for i in 0..10 {
    series.push(Point2D::new(i as f32, i as f32)).unwrap();
}

// This will return BufferFull error with context
match series.push(Point2D::new(10.0, 10.0)) {
    Err(DataError::BufferFull { context: Some(ctx) }) => {
        println!("Series is full: {}", ctx.hint);
    },
    _ => unreachable!(),
}

Variants

SeriesNotFound

Requested data series was not found.

Occurs when trying to access a data series by name or index that doesn’t exist in the collection.

Fields

context: Option<ErrorContext>

Optional context information

IndexOutOfBounds

Index is out of bounds for the data collection.

Returned when accessing data with an invalid index.

Fields

context: Option<ErrorContext>

Optional context information

InvalidDataPoint

Invalid data point provided.

Occurs when a data point contains invalid values such as NaN, infinity, or values outside acceptable ranges.

Fields

context: Option<ErrorContext>

Optional context information

ScalingError

Error occurred during data scaling.

Returned when data scaling or normalization operations fail, typically due to invalid ranges or mathematical errors.

Fields

context: Option<ErrorContext>

Optional context information

BufferFull

Buffer capacity exceeded.

Occurs when trying to add data to a full static buffer.

Fields

context: Option<ErrorContext>

Optional context information

InsufficientData

Insufficient data to perform operation.

Returned when an operation requires a minimum amount of data that isn’t available.

Fields

context: Option<ErrorContext>

Optional context information

Implementations

impl DataError

pub const fn buffer_full(operation: &'static str, capacity: usize) -> Self

Create a BufferFull error with context

pub const fn insufficient_data( operation: &'static str, _required: usize, found: usize, ) -> Self

Create an InsufficientData error with context

pub const fn index_out_of_bounds( operation: &'static str, _index: usize, length: usize, ) -> Self

Create an IndexOutOfBounds error with context

pub const fn invalid_data_point(operation: &'static str) -> Self

Create an InvalidDataPoint error with context

pub const fn simple(kind: DataErrorKind) -> Self

Create a simple error without context (for backwards compatibility)

impl DataError

pub const SERIES_NOT_FOUND: Self

Backwards compatibility: SeriesNotFound variant without context

pub const INDEX_OUT_OF_BOUNDS: Self

Backwards compatibility: IndexOutOfBounds variant without context

pub const INVALID_DATA_POINT: Self

Backwards compatibility: InvalidDataPoint variant without context

pub const SCALING_ERROR: Self

Backwards compatibility: ScalingError variant without context

pub const BUFFER_FULL: Self

Backwards compatibility: BufferFull variant without context

pub const INSUFFICIENT_DATA: Self

Backwards compatibility: InsufficientData variant without context

Trait Implementations

impl Clone for DataError

fn clone(&self) -> DataError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataError

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

Formats the value using the given formatter.

impl Display for DataError

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

Formats the value using the given formatter.

impl Error for DataError

Available on crate feature std only.

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 From<&str> for DataError

fn from(_msg: &str) -> Self

Converts to this type from the input type.

impl From<DataError> for ChartError

fn from(error: DataError) -> Self

Converts to this type from the input type.

impl PartialEq for DataError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DataError

impl Eq for DataError

impl StructuralPartialEq for DataError