Clippy lints / Complexity
Clippy lint · Complexity · checked with Clippy 0.1.99
clippy::needless_match: Checks for unnecessary match or match-like if let returns for Option and Result when function signatures are the same
What it meansChecks for unnecessary match or match-like if let returns for Option and Result when function signatures are the same. It is in the complexity group and warns by default.
Does it matter?
This match block does nothing and might not be what the coder intended.
Code that does something simple in a complicated way. Warns by default.
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() -> Result<(), i32> {
match result {
Ok(val) => Ok(val),
Err(err) => Err(err),
}
}
fn bar() -> Option<i32> {
if let Some(val) = option {
Some(val)
} else {
None
}
}
Write this instead
fn foo() -> Result<(), i32> {
result
}
fn bar() -> Option<i32> {
option
}
Turn it off, or on
Allow it where it does not fit your code, as narrowly as you can:
On one item
#[allow(clippy::needless_match)]
fn my_function() { /* ... */ }Whole crate (Cargo.toml)
[lints.clippy]
needless_match = "allow"One run
cargo clippy -- -A clippy::needless-matchThe [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 unnecessary match or match-like if let returns for Option and Result
when function signatures are the same.
Why is this bad?
This match block does nothing and might not be what the coder intended.
Example
fn foo() -> Result<(), i32> {
match result {
Ok(val) => Ok(val),
Err(err) => Err(err),
}
}
fn bar() -> Option<i32> {
if let Some(val) = option {
Some(val)
} else {
None
}
}
Could be replaced as
fn foo() -> Result<(), i32> {
result
}
fn bar() -> Option<i32> {
option
}
From the Clippy lint list (0.1.99), part of the Rust project, MIT or Apache-2.0. Official entry.
Related lints
- too_many_argumentsChecks for functions with too many parameters
- clone_on_copyusing `clone` on type `u64` which implements the `Copy` trait
- type_complexityChecks for types used in structs, parameters and let declarations above a certain complexity threshold
- needless_borrowed_referencethis pattern takes a reference on something that is being dereferenced
- needless_ifsChecks for empty if branches with no else branch
- needless_lifetimesthe following explicit lifetimes could be elided: 'a
- needless_option_as_derefderefed type is same as origin
- needless_option_takecalled `Option::take()` on a temporary value
- needless_question_markSuggests replacing Ok(x?) or Some(x?) with x in return positions where the ? operator is not needed to convert the type of x
All 847 Clippy lints · Rust compiler errors · Cargo.toml checker
Up next
Related lintclippy::too_many_argumentsChecks for functions with too many parametersRead it next →Did this answer your question?