← Rule catalog

Clippy · Correctness

Guarded subtraction with operands in wrong order

clippy::inverted_saturating_sub

Swap the operands: the guard proves the subtraction as written underflows.

Category
Correctness
Default level
warn
Tier
P1
Producer
Clippy
Diff scope
line

Not a defect when

The guarded branch is meant to produce zero and the saturating_sub is written that way for symmetry with a sibling branch, though returning 0 states it directly.

What it reads

Clippy, with the compiler behind it. The only pass that compiles.

Tier

Serious: worth interrupting other work for.

The tier bounds how severe a rule may be; its category bounds the tier.

Diff scope

The changed line itself.

What --scope contextual looks at to decide whether a change caused the finding.

Change it

Turn it off, or make it blocking, without touching the code it flags:

rust-doctor --rule clippy::inverted_saturating_sub=off .
rust-doctor --rule clippy::inverted_saturating_sub=error .

Set it once in rust-doctor.toml

Upstream

Clippy's own documentation for this lint

Other Correctness rules