saturating_sub in std::intrinsics - Rust
Description: Computes `a - b`, saturating at numeric bounds.
Keywords: rust, rustlang, rust-lang, saturating_sub

# Function std::intrinsics::saturating_sub
[−][src]

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

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

intrinsics are unlikely to ever be stabilized, instead they should be used through stabilized interfaces in the rest of the standard library

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`