approxeq

Crates.ioapproxeq
lib.rsapproxeq
version0.1.1
sourcesrc
created_at2020-11-18 01:19:13.647254
updated_at2020-11-18 16:42:25.029558
descriptionA trait for approximate equality of types
homepage
repositoryhttps://github.com/mibmo/approxeq
max_upload_size
id313517
size10,014
mib (mibmo)

documentation

https://docs.rs/approxeq

README

ApproxEq

Crate Documentation Current Crates.io Version

The ApproxEq trait handily provides a way to define approximate relations between types and comes with already-declared arbitrary implementations for primitive number types!

Easily define implementations for your own types:

use approxeq::ApproxEq;

enum BookFormat {
    Paperback,
    Hardback,
    Ebook,
}

struct Book {
    isbn: i32,
    format: BookFormat,
}

impl ApproxEq for Book {
    // Two books are approximately equal when their respective ISBNs parity matches
    fn aeq(&self, &other: Self) -> bool {
        self.isbn % 2 == other.isbn %2
    }
}

fn main() {
    let b1 = Book { isbn: 3, format: Paperback }
    let b2 = Book { isbn: 5, format: Hardback }
    let b3 = Book { isbn: 10, format: Ebook }

    assert!(b1.aeq(&b2));
    assert!(b1.nae(&b3));
}

Contributing

Any and all PRs are welcome.

Acknowledgement

The ApproxEq crate is what you might call a joke.

Much of the documentation is an adaptation of rust-lang's std::cmp::PartialEq trait documentation.

Commit count: 15

cargo fmt