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

### What it does
Checks for casts between numerical types that may
be replaced by safe conversion functions.

### Why is this bad?
Rust's `as` keyword will perform many kinds of
conversions, including silently lossy conversions. Conversion functions such
as `i32::from` will only perform lossless conversions. Using the conversion
functions prevents conversions from turning into silent lossy conversions if
the types of the input expressions ever change, and make it easier for
people reading the code to know that the conversion is lossless.

### Example
```
fn as_u64(x: u8) -> u64 {
    x as u64
}
```

Using `::from` would look like this:

```
fn as_u64(x: u8) -> u64 {
    u64::from(x)
}
```
Commit	Line	Data
f2b60f7d FG	1	### What it does
	2	Checks for casts between numerical types that may
	3	be replaced by safe conversion functions.
	4
	5	### Why is this bad?
	6	Rust's `as` keyword will perform many kinds of
	7	conversions, including silently lossy conversions. Conversion functions such
	8	as `i32::from` will only perform lossless conversions. Using the conversion
	9	functions prevents conversions from turning into silent lossy conversions if
	10	the types of the input expressions ever change, and make it easier for
	11	people reading the code to know that the conversion is lossless.
	12
	13	### Example
	14	```
	15	fn as_u64(x: u8) -> u64 {
	16	x as u64
	17	}
	18	```
	19
	20	Using `::from` would look like this:
	21
	22	```
	23	fn as_u64(x: u8) -> u64 {
	24	u64::from(x)
	25	}
	26	```