overf

Crates.iooverf
lib.rsoverf
version0.1.3
created_at2024-11-12 15:41:48.539738+00
updated_at2025-08-30 11:38:27.819442+00
descriptionCustomize overflow behavior in mathematical operations.
homepagehttps://github.com/makcandrov/overf
repositoryhttps://github.com/makcandrov/overf
max_upload_size
id1445088
size34,853
(makcandrov)

documentation

https://docs.rs/overf

README

overf

github crates.io docs.rs

Define the overflow behavior of mathematical operations within blocks of code. This library provides the macros checked!, overflowing!, saturating!, propagating! and default!, enabling you to easily manage overflow in nested contexts.

Usage

use overf::{checked, overflowing, saturating, default};

checked! {
    let result = 1usize + 1usize;
    let sum = default! { 2usize + 2usize }; // Use default behavior
    let difference = 5usize - 3usize;

    // Nested blocks
    saturating! {
        let total = 100u8 - 200u8;
    }
}

overflowing! {
    let result = 1usize + usize::MAX;
}

Features

  • Customizable Overflow Behavior: Choose between checked, overflowing, and saturating operations for any block of code.
  • Nested Blocks: Define different overflow behaviors in nested blocks for more granular control.
  • Reset Behavior: Use the default! macro to reset the overflow behavior back to the default.

Installation

Add overf to your Cargo.toml:

[dependencies]
overf = "0.1"

Or run the following command:

cargo add overf
Commit count: 8

cargo fmt