summaryrefslogtreecommitdiffstats
path: root/src/tools/clippy/src/docs/cast_possible_wrap.txt
blob: f883fc9cfb994793e5520453df94f183d2230319 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
### What it does
Checks for casts from an unsigned type to a signed type of
the same size. Performing such a cast is a 'no-op' for the compiler,
i.e., nothing is changed at the bit level, and the binary representation of
the value is reinterpreted. This can cause wrapping if the value is too big
for the target signed type. However, the cast works as defined, so this lint
is `Allow` by default.

### Why is this bad?
While such a cast is not bad in itself, the results can
be surprising when this is not the intended behavior, as demonstrated by the
example below.

### Example
```
u32::MAX as i32; // will yield a value of `-1`
```