Enum CarlaError 

pub enum CarlaError {
    Connection(ConnectionError),
    Resource(ResourceError),
    Operation(OperationError),
    Validation(ValidationError),
    Map(MapError),
    Sensor(SensorError),
    Internal(InternalError),
    Io(Error),
}

Main error type for all CARLA operations.

This enum categorizes errors into actionable groups, allowing users to handle specific error conditions with appropriate recovery strategies.

Variants

Connection(ConnectionError)

Connection-related errors (network, timeouts, disconnections)

Resource(ResourceError)

Resource-related errors (actors, blueprints not found, etc.)

Operation(OperationError)

Operation failures (spawn, physics, simulation errors)

Validation(ValidationError)

Validation errors (invalid parameters, out of bounds, etc.)

Map(MapError)

Map-related errors (loading, waypoints, topology)

Sensor(SensorError)

Sensor-related errors (data, configuration, listening)

Internal(InternalError)

Internal errors (FFI, unexpected states, bugs)

Io(Error)

I/O errors (file operations)

Implementations

impl CarlaError

pub fn is_connection_error(&self) -> bool

Returns true if this is a connection-related error.

Examples

let error: CarlaError = ConnectionError::Timeout {
    operation: "spawn".to_string(),
    duration: Duration::from_secs(5),
    source: None,
}
.into();

assert!(error.is_connection_error());

pub fn is_timeout(&self) -> bool

Returns true if this is a timeout error.

Examples

let error: CarlaError = ConnectionError::Timeout {
    operation: "spawn".to_string(),
    duration: Duration::from_secs(5),
    source: None,
}
.into();

assert!(error.is_timeout());

pub fn is_not_found(&self) -> bool

Returns true if this is a resource not found error.

Examples

let error: CarlaError = ResourceError::NotFound {
    resource_type: ResourceType::Blueprint,
    identifier: "vehicle.tesla.model3".to_string(),
    context: None,
}
.into();

assert!(error.is_not_found());

pub fn is_retriable(&self) -> bool

Returns true if this error should be retried.

This includes:

• Timeout errors
• Disconnection errors
• Some spawn failures

Examples

let error: CarlaError = ConnectionError::Timeout {
    operation: "spawn".to_string(),
    duration: Duration::from_secs(5),
    source: None,
}
.into();

assert!(error.is_retriable());

Trait Implementations

impl Debug for CarlaError

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

Formats the value using the given formatter.

impl Display for CarlaError

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

Formats the value using the given formatter.

impl Error for CarlaError

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<ConnectionError> for CarlaError

fn from(source: ConnectionError) -> Self

Converts to this type from the input type.

impl From<Error> for CarlaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<InternalError> for CarlaError

fn from(source: InternalError) -> Self

Converts to this type from the input type.

impl From<MapError> for CarlaError

fn from(source: MapError) -> Self

Converts to this type from the input type.

impl From<OperationError> for CarlaError

fn from(source: OperationError) -> Self

Converts to this type from the input type.

impl From<ResourceError> for CarlaError

fn from(source: ResourceError) -> Self

Converts to this type from the input type.

impl From<SensorError> for CarlaError

fn from(source: SensorError) -> Self

Converts to this type from the input type.

impl From<ValidationError> for CarlaError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.