# Function std::intrinsics::saturating_sub

const: 1.40.0 · source ·

    pub const extern "rust-intrinsic" fn saturating_sub<T>(
        a: T,
        b: T
    ) -> Twhere
        T: Copy,

🔬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`