Struct Error

pub struct Error { /* private fields */ }

An error returned from various “easy” operations.

This structure wraps a CURLcode.

Implementations

impl Error

pub fn new(code: CURLcode) -> Error

Creates a new error from the underlying code returned by libcurl.

pub fn set_extra(&mut self, extra: String)

Stores some extra information about this error inside this error.

This is typically used with take_error_buf on the easy handles to couple the extra CURLOPT_ERRORBUFFER information with an Error being returned.

pub fn is_unsupported_protocol(&self) -> bool

Returns whether this error corresponds to CURLE_UNSUPPORTED_PROTOCOL.

pub fn is_failed_init(&self) -> bool

Returns whether this error corresponds to CURLE_FAILED_INIT.

pub fn is_url_malformed(&self) -> bool

Returns whether this error corresponds to CURLE_URL_MALFORMAT.

pub fn is_couldnt_resolve_proxy(&self) -> bool

Returns whether this error corresponds to CURLE_COULDNT_RESOLVE_PROXY.

pub fn is_couldnt_resolve_host(&self) -> bool

Returns whether this error corresponds to CURLE_COULDNT_RESOLVE_HOST.

pub fn is_couldnt_connect(&self) -> bool

Returns whether this error corresponds to CURLE_COULDNT_CONNECT.

pub fn is_remote_access_denied(&self) -> bool

Returns whether this error corresponds to CURLE_REMOTE_ACCESS_DENIED.

pub fn is_partial_file(&self) -> bool

Returns whether this error corresponds to CURLE_PARTIAL_FILE.

pub fn is_quote_error(&self) -> bool

Returns whether this error corresponds to CURLE_QUOTE_ERROR.

pub fn is_http_returned_error(&self) -> bool

Returns whether this error corresponds to CURLE_HTTP_RETURNED_ERROR.

pub fn is_read_error(&self) -> bool

Returns whether this error corresponds to CURLE_READ_ERROR.

pub fn is_write_error(&self) -> bool

Returns whether this error corresponds to CURLE_WRITE_ERROR.

pub fn is_upload_failed(&self) -> bool

Returns whether this error corresponds to CURLE_UPLOAD_FAILED.

pub fn is_out_of_memory(&self) -> bool

Returns whether this error corresponds to CURLE_OUT_OF_MEMORY.

pub fn is_operation_timedout(&self) -> bool

Returns whether this error corresponds to CURLE_OPERATION_TIMEDOUT.

pub fn is_range_error(&self) -> bool

Returns whether this error corresponds to CURLE_RANGE_ERROR.

pub fn is_http_post_error(&self) -> bool

Returns whether this error corresponds to CURLE_HTTP_POST_ERROR.

pub fn is_ssl_connect_error(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CONNECT_ERROR.

pub fn is_bad_download_resume(&self) -> bool

Returns whether this error corresponds to CURLE_BAD_DOWNLOAD_RESUME.

pub fn is_file_couldnt_read_file(&self) -> bool

Returns whether this error corresponds to CURLE_FILE_COULDNT_READ_FILE.

pub fn is_function_not_found(&self) -> bool

Returns whether this error corresponds to CURLE_FUNCTION_NOT_FOUND.

pub fn is_aborted_by_callback(&self) -> bool

Returns whether this error corresponds to CURLE_ABORTED_BY_CALLBACK.

pub fn is_bad_function_argument(&self) -> bool

Returns whether this error corresponds to CURLE_BAD_FUNCTION_ARGUMENT.

pub fn is_interface_failed(&self) -> bool

Returns whether this error corresponds to CURLE_INTERFACE_FAILED.

pub fn is_too_many_redirects(&self) -> bool

Returns whether this error corresponds to CURLE_TOO_MANY_REDIRECTS.

pub fn is_unknown_option(&self) -> bool

Returns whether this error corresponds to CURLE_UNKNOWN_OPTION.

pub fn is_peer_failed_verification(&self) -> bool

Returns whether this error corresponds to CURLE_PEER_FAILED_VERIFICATION.

pub fn is_got_nothing(&self) -> bool

Returns whether this error corresponds to CURLE_GOT_NOTHING.

pub fn is_ssl_engine_notfound(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_ENGINE_NOTFOUND.

pub fn is_ssl_engine_setfailed(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_ENGINE_SETFAILED.

pub fn is_send_error(&self) -> bool

Returns whether this error corresponds to CURLE_SEND_ERROR.

pub fn is_recv_error(&self) -> bool

Returns whether this error corresponds to CURLE_RECV_ERROR.

pub fn is_ssl_certproblem(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CERTPROBLEM.

pub fn is_ssl_cipher(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CIPHER.

pub fn is_ssl_cacert(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CACERT.

pub fn is_bad_content_encoding(&self) -> bool

Returns whether this error corresponds to CURLE_BAD_CONTENT_ENCODING.

pub fn is_filesize_exceeded(&self) -> bool

Returns whether this error corresponds to CURLE_FILESIZE_EXCEEDED.

pub fn is_use_ssl_failed(&self) -> bool

Returns whether this error corresponds to CURLE_USE_SSL_FAILED.

pub fn is_send_fail_rewind(&self) -> bool

Returns whether this error corresponds to CURLE_SEND_FAIL_REWIND.

pub fn is_ssl_engine_initfailed(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_ENGINE_INITFAILED.

pub fn is_login_denied(&self) -> bool

Returns whether this error corresponds to CURLE_LOGIN_DENIED.

pub fn is_conv_failed(&self) -> bool

Returns whether this error corresponds to CURLE_CONV_FAILED.

pub fn is_conv_required(&self) -> bool

Returns whether this error corresponds to CURLE_CONV_REQD.

pub fn is_ssl_cacert_badfile(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CACERT_BADFILE.

pub fn is_ssl_crl_badfile(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_CRL_BADFILE.

pub fn is_ssl_shutdown_failed(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_SHUTDOWN_FAILED.

pub fn is_again(&self) -> bool

Returns whether this error corresponds to CURLE_AGAIN.

pub fn is_ssl_issuer_error(&self) -> bool

Returns whether this error corresponds to CURLE_SSL_ISSUER_ERROR.

pub fn is_chunk_failed(&self) -> bool

Returns whether this error corresponds to CURLE_CHUNK_FAILED.

pub fn is_http2_error(&self) -> bool

Returns whether this error corresponds to CURLE_HTTP2.

pub fn is_http2_stream_error(&self) -> bool

Returns whether this error corresponds to CURLE_HTTP2_STREAM.

pub fn code(&self) -> CURLcode

Returns the value of the underlying error corresponding to libcurl.

pub fn description(&self) -> &str

Returns the general description of this error code, using curl’s builtin strerror-like functionality.

pub fn extra_description(&self) -> Option<&str>

Returns the extra description of this error, if any is available.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy 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, f: &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 From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<NulError> for Error

fn from(_: NulError) -> Error

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> 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 StructuralPartialEq for Error