Enum ParseError 

#[non_exhaustive]
pub enum ParseError {
    Decimal(Error),
    Json(Error),
    Timestamp(Cow<'static, str>),
    MissingField(Cow<'static, str>),
    InvalidValue {
        field: Cow<'static, str>,
        message: Cow<'static, str>,
    },
    InvalidFormat {
        field: Cow<'static, str>,
        message: Cow<'static, str>,
    },
}

Errors related to parsing exchange responses.

This type handles all parsing failures including JSON deserialization, decimal number parsing, timestamp parsing, and missing/invalid fields.

Memory Optimization

Uses Cow<'static, str> for field names and messages to avoid allocation when using static strings. Use the helper constructors for ergonomic creation:

use ccxt_core::error::ParseError;

// Zero allocation (static string)
let err = ParseError::missing_field("price");

// Allocation only when needed (dynamic string)
let field_name = format!("field_{}", 42);
let err = ParseError::missing_field_owned(field_name);

// Invalid value with context
let err = ParseError::invalid_value("amount", "must be positive");

Example

use ccxt_core::error::{Error, ParseError, Result};

fn parse_price(json: &serde_json::Value) -> Result<f64> {
    json.get("price")
        .and_then(|v| v.as_f64())
        .ok_or_else(|| Error::from(ParseError::missing_field("price")))
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Decimal(Error)

Failed to parse decimal number.

Json(Error)

Failed to deserialize JSON.

Timestamp(Cow<'static, str>)

Failed to parse timestamp.

MissingField(Cow<'static, str>)

Missing required field in response.

InvalidValue

Invalid value for a field.

Fields

field: Cow<'static, str>

Field name

message: Cow<'static, str>

Error message

InvalidFormat

Invalid format for a field.

Fields

field: Cow<'static, str>

Field name

message: Cow<'static, str>

Error message

Implementations

impl ParseError

pub fn missing_field(field: &'static str) -> Self

Creates a MissingField error with a static string (no allocation).

pub fn missing_field_owned(field: String) -> Self

Creates a MissingField error with a dynamic string.

pub fn invalid_value( field: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, ) -> Self

Creates an InvalidValue error.

pub fn timestamp(message: &'static str) -> Self

Creates a Timestamp error with a static string (no allocation).

pub fn timestamp_owned(message: String) -> Self

Creates a Timestamp error with a dynamic string.

pub fn invalid_format( field: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, ) -> Self

Creates an InvalidFormat error.

Trait Implementations

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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<Error> for ParseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ParseError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(e: ParseError) -> Self

Converts to this type from the input type.