Enum Error 

pub enum Error {
    Comm(String),
    Data(String),
    BufferEmpty,
    Response {
        message: String,
        kind: Option<ErrorKind>,
        status: Option<u8>,
        ext: Option<u16>,
    },
    Request {
        message: String,
        kind: Option<ErrorKind>,
    },
}

Errors raised by ciplink, one variant per exception class of the Python package.

Variants

Comm(String)

Connection related failure (CommError).

Data(String)

Binary encoding or decoding failed (DataError).

BufferEmpty

Decoding found no data at all where a value should start (BufferEmptyError).

Response

A reply could not be used (ResponseError); kind is set when the cause is classified.

Fields

message: String

Message.

kind: Option<ErrorKind>

Classification carried with the error, if any.

status: Option<u8>

CIP general status, if a controller status caused it.

ext: Option<u16>

First extended status word, if any.

Request

A request could not be built from the caller’s input (RequestError).

Fields

message: String

Message.

kind: Option<ErrorKind>

Classification carried with the error, if any.

Implementations

impl Error

pub fn request(message: impl Into<String>) -> Self

A RequestError without a classification.

pub fn request_kind(message: impl Into<String>, kind: ErrorKind) -> Self

A RequestError carrying an ErrorKind.

pub fn response(message: impl Into<String>) -> Self

A ResponseError without a classification.

pub fn response_tag(error: TagError) -> Self

A ResponseError carrying a TagError’s classification.

pub fn data(message: impl Into<String>) -> Self

A DataError.

pub fn comm(message: impl Into<String>) -> Self

A CommError.

pub fn carried_kind(&self) -> Option<ErrorKind>

The classification this error carries, if any.

pub fn default_kind(&self) -> ErrorKind

The default kind of an error caught around a request: RequestError is a bad request, CommError a communication failure, anything else a device error.

pub fn to_tag_error(&self, kind: ErrorKind, message: Option<String>) -> TagError

This error as a TagError: the kind (and status) it carries, else kind; its message unless message replaces it.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error