Clippy lints / Restriction
Clippy lint · Restriction · checked with Clippy 0.1.99
clippy::try_err: returning an `Err(_)` with the `?` operator
What it meansChecks for usage of Err(x)?. It is in the restriction group and off by default.
What you see
warning: returning an `Err(_)` with the `?` operator --> main.rs:5:7 | 5 | Err("failed")?; | ^^^^^^^^^^^^^^ help: try: `return Err("failed".into())` | = help: for further information visit https://rust-lang.github.io/rust-clippy/stable/index.html#try_err = note: requested on the command line with `-W clippy::try-err`
Real output of Clippy 0.1.99 (Rust 1.99) on the example below. Names and line numbers in yours will differ.
Does it matter?
The ? operator is designed to allow calls that can fail to be easily chained. For example, foo()?.bar() or foo(bar()?). Because Err(x)? can’t be used that way (it will always return), it is more clear to write return Err(x).
Lints that forbid language features for specific codebases (no unwrap, no indexing...). Off by default; pick them one by one, never the whole group.
How to fix it
Clippy can fix this one for you: run cargo clippy --fix (add --allow-dirty if you have uncommitted changes). Review the diff before you commit.
Flagged
fn foo(fail: bool) -> Result<i32, String> {
if fail {
Err("failed")?;
}
Ok(0)
}
Write this instead
fn foo(fail: bool) -> Result<i32, String> {
if fail {
return Err("failed".into());
}
Ok(0)
}
Turn it off, or on
It is off by default. To use it, set it to warn or deny:
Whole crate (Cargo.toml)
[lints.clippy]
try_err = "warn"In code
#![warn(clippy::try_err)]One run
cargo clippy -- -W clippy::try-errThe [lints] table needs Rust 1.74 or newer. In a workspace, put it under [workspace.lints.clippy] and add [lints] workspace = true to each member.
Clippy's own documentation
What it does
Checks for usage of Err(x)?.
Why restrict this?
The ? operator is designed to allow calls that
can fail to be easily chained. For example, foo()?.bar() or
foo(bar()?). Because Err(x)? can’t be used that way (it will
always return), it is more clear to write return Err(x).
Example
fn foo(fail: bool) -> Result<i32, String> {
if fail {
Err("failed")?;
}
Ok(0)
}
Could be written:
fn foo(fail: bool) -> Result<i32, String> {
if fail {
return Err("failed".into());
}
Ok(0)
}
From the Clippy lint list (0.1.99), part of the Rust project, MIT or Apache-2.0. Official entry.
Related lints
- unwrap_usedChecks for .unwrap() or .unwrap_err() calls on Results and .unwrap() call on Options
- module_name_repetitionsDetects public item names that are prefixed or suffixed by the containing public module’s name
- expect_usedChecks for .expect() or .expect_err() calls on Results and .expect() call on Options
- suspicious_xor_used_as_pow`^` is not the exponentiation operator
- tests_outside_test_moduleTriggers when a testing function (marked with the #[test] attribute) isn’t inside a testing module (marked with #[cfg(test)])
- todo`todo` should not be present in production code
- undocumented_unsafe_blocksChecks for unsafe blocks and impls without a // SAFETY: comment explaining why the unsafe operations performed inside the block are safe. Note the comment must appear on the line(s) preceding the unsafe block with nothing appearing in between
- unimplemented`unimplemented` should not be present in production code
- unnecessary_rest_patternunnecessary rest pattern (`..`)
All 847 Clippy lints · Rust compiler errors · Cargo.toml checker
Up next
Related lintclippy::unwrap_usedChecks for .unwrap() or .unwrap_err() calls on Results and .unwrap() call on OptionsRead it next →Did this answer your question?