[rustc.git] / src / tools / clippy / src / docs / implicit_saturating_sub.txt

### What it does
Checks for implicit saturating subtraction.

### Why is this bad?
Simplicity and readability. Instead we can easily use an builtin function.

### Example
```
let mut i: u32 = end - start;

if i != 0 {
    i -= 1;
}
```

Use instead:
```
let mut i: u32 = end - start;

i = i.saturating_sub(1);
```
Commit	Line	Data
f2b60f7d FG	1	### What it does
	2	Checks for implicit saturating subtraction.
	3
	4	### Why is this bad?
	5	Simplicity and readability. Instead we can easily use an builtin function.
	6
	7	### Example
	8	```
	9	let mut i: u32 = end - start;
	10
	11	if i != 0 {
	12	i -= 1;
	13	}
	14	```
	15
	16	Use instead:
	17	```
	18	let mut i: u32 = end - start;
	19
	20	i = i.saturating_sub(1);
	21	```