overf

Crates.iooverf
lib.rsoverf
version0.1.1
sourcesrc
created_at2024-11-12 15:41:48.539738
updated_at2024-11-16 04:33:26.616948
descriptionCustomize overflow behavior in mathematical operations.
homepagehttps://github.com/makcandrov/overf
repositoryhttps://github.com/makcandrov/overf
max_upload_size
id1445088
size33,715
(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.

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 the following to your Cargo.toml:

[dependencies]
overf = "0.1"

Usage

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

fn main() {
    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;
    }
}
Commit count: 4

cargo fmt