Struct clap::Error

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

Command Line Argument Parser 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 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 1 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

Create an error with a custom description.

This can be used in combination with Error::exit to exit your program with a custom error message.

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.