Struct clap::Error

pub struct Error {
    pub kind: ErrorKind,
    pub info: Vec<String>,
    // some fields omitted
}

Command Line Argument Parser Error

See App::error to create an error.

Fields

kind: ErrorKind

The type of error

info: Vec<String>

Additional information depending on the error kind, like values and argument names. Useful when you want to render an error of your own.

Implementations

impl Error

pub fn raw(kind: ErrorKind, message: impl Display) -> Self

Create an unformatted error

This is for you need to pass the error up to a place that has access to the App at which point you can call Error::format.

Prefer App::error for generating errors.

pub fn format(self, app: &mut App<'_>) -> Self

Format the existing message with the App’s context

pub fn use_stderr(&self) -> bool

Should the message be written to stdout or not?

pub fn exit(&self) -> !

Prints the error and exits.

Depending on the error kind, this either prints to stderr and exits with a status of 2 or prints to stdout and exits with a status of 0.

pub fn print(&self) -> Result<()>

Prints formatted and colored error to stdout or stderr according to its error kind

Example

use clap::App;

match App::new("App").try_get_matches() {
    Ok(matches) => {
        // do_something
    },
    Err(err) => {
        err.print().expect("Error writing Error");
        // do_something
    },
};

pub fn with_description(description: String, kind: ErrorKind) -> Self

👎 Deprecated since 3.0.0:

Replaced with App::error

Deprecated, replaced with App::error

Trait Implementations

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)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<Error> for Error

fn from(e: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(e: Error) -> Self

Performs the conversion.