saturating_sub in core::intrinsics - Rust
Description: Computes `a - b`, saturating at numeric bounds.

# Function saturating_sub

Source

    pub const fn saturating_sub<T: Copy>(a: T, b: T) -> T

🔬This is a nightly-only experimental API. (`core_intrinsics`)
Expand description

Computes `a - b`, saturating at numeric bounds.

Note that, unlike most intrinsics, this is safe to call; it does not require an `unsafe` block. Therefore, implementations must not require the user to uphold any safety invariants.

The stabilized versions of this intrinsic are available on the integer primitives via the `saturating_sub` method. For example, `u32::saturating_sub`