Skip to content

Commit 50ad38f

Browse files
committed
Add links
1 parent bf131d2 commit 50ad38f

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

src/coding-guidelines/types-and-traits.rst

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,17 @@ Types and Traits
2424
:status: draft
2525

2626
In debug builds, Rust performs runtime checks for integer overflow and will panic if detected.
27-
However, in release builds (with optimizations enabled), unless the flag overflow-checks is
27+
However, in release builds (with optimizations enabled), unless the flag `overflow-checks`_ is
2828
turned on, integer operations silently wrap around on overflow, creating potential for silent
2929
failures and security vulnerabilities. Note that overflow-checks only brings the default panic
3030
behavior from debug into release builds, avoiding potential silent wrap arounds. Nonetheless,
3131
abrupt program termination is usually not suitable and, therefore, turning this flag on must
32-
not be used as a substitute of explicit handling.
32+
not be used as a substitute of explicit handling. Furthermore, the behavior in release mode is
33+
under consideration by the The Rust Language Design Team and in the future overflow checking
34+
may be turned on by default in release builds (it is a `frequently requested change`_).
35+
36+
.. _overflow-checks: https://github.com/rust-lang/rust/blob/master/src/doc/rustc/src/codegen-options/index.md#overflow-checks
37+
.. _frequently requested change: https://lang-team.rust-lang.org/frequently-requested-changes.html#numeric-overflow-checking-should-be-on-by-default-even-in-release-mode
3338

3439
Safety-critical software requires consistent and predictable behavior across all build
3540
configurations. Explicit handling of potential overflow conditions improves code clarity,

0 commit comments

Comments
 (0)