rust-lang / rust · Issue No. 163061

std's api docs should defines overflowing/wrapping/saturating

Openby liigoopened Sep 20, 2026updated Sep 20, 20262 comments

E-easyA-docsneeds-triage

Description

Location (URL)

https://doc.rust-lang.org/std/primitive.i8.html#method.saturating_add etc. lacks the definition of overflowing / wrapping / saturating operations.

Summary

C++ 26's saturating_add links to wikipedia, which is a good idea. We can do things similar, maybe in a dedicated page somewhere.

Relay Analysis

View on GitHub

Relay reads this issue against the repository's contribution signals: the files it is likely to touch, how the maintainers triage work this size, and what the first contribution would exercise.

The full analysis for this issue is still being assembled. Until then, the description above and the thread on GitHub are the most reliable context.