chain-cmp

Crates.iochain-cmp
lib.rschain-cmp
version0.2.0
sourcesrc
created_at2020-09-10 18:17:44.762968
updated_at2020-09-10 18:17:44.762968
descriptionChain comparison operators easily
homepage
repositoryhttps://github.com/isaacthefallenapple/chain_cmp
max_upload_size
id287100
size9,306
(isaacthefallenapple)

documentation

README

chain_cmp

Use the chmp! macro to chain comparison operators like you can in Python, for example.

You can use all of these operators <, <=, >, >=, ==, != inside a chmp! invocation.

Examples

Basic usage

use chain_cmp::chmp;

let (a, b, c) = (1, 2, 3);

let verbose = a < b && b <= c;
let concise = chmp!(a < b <= c);
assert_eq!(concise, verbose);

// You can use equality operators as well:
assert!(chmp!(a != b != c));

// And you can even chain more than three operators:
assert!(chmp!(a != b != c != a)); // making sure these values are pairwise distinct

// And of course mix and match operators:
assert!(chmp!(a < b <= c != a == a));

Short-circuiting

chmp! will short-circuit to evaluate the fewest expressions possible.

fn panics() -> i32 {
    panic!();
}

assert!(!chmp!(i32::MAX < i32::MIN < panics())); // this **won't** panic

Comparing arbitrary expressions

As long as the comparison operators have the lowest precedence, chmp! will evaluate any expression, like variables, blocks, function calls, etc.

const ANSWER: u32 = 42;

assert!(chmp!({
    println!("Life, the Universe, and Everything");
    ANSWER
} != 6 * 9 == 54));
Commit count: 6

cargo fmt