4 releases

0.2.0 Mar 23, 2024
0.1.2 Nov 3, 2023
0.1.1 Nov 3, 2023
0.1.0 Nov 3, 2023

#1537 in Rust patterns

Download history 2903/week @ 2024-08-04 2627/week @ 2024-08-11 4110/week @ 2024-08-18 4928/week @ 2024-08-25 5344/week @ 2024-09-01 4878/week @ 2024-09-08 5928/week @ 2024-09-15 7050/week @ 2024-09-22 7922/week @ 2024-09-29 6279/week @ 2024-10-06 7021/week @ 2024-10-13 7323/week @ 2024-10-20 6813/week @ 2024-10-27 6925/week @ 2024-11-03 5609/week @ 2024-11-10 6299/week @ 2024-11-17

26,266 downloads per month
Used in 38 crates (7 directly)

MIT/Apache

12KB
84 lines

Hash trait that is object-safe

github crates.io docs.rs build status

This crate provides a DynHash trait that can be used in trait objects. Types that implement the standard library's std::hash::Hash trait are automatically usable by a DynHash trait object.

Example

use dyn_hash::DynHash;

trait MyTrait: DynHash {
    /* ... */
}

// Implement std::hash::Hash for dyn MyTrait
dyn_hash::hash_trait_object!(MyTrait);

// Now data structures containing Box<dyn MyTrait> can derive Hash:
#[derive(Hash)]
struct Container {
    trait_object: Box<dyn MyTrait>,
}

Without the dyn-hash crate, a trait trait MyTrait: std::hash::Hash {...} would not be object-safe (dyn MyTrait).

error[E0038]: the trait `MyTrait` cannot be made into an object
 --> src/main.rs:7:12
  |
7 |     let _: &dyn MyTrait;
  |            ^^^^^^^^^^^^ `MyTrait` cannot be made into an object
  |
note: for a trait to be "object safe" it needs to allow building a vtable to allow the call to be resolvable dynamically; for more information visit <https://doc.rust-lang.org/reference/items/traits.html#object-safety>
 --> $SYSROOT/lib/rustlib/src/rust/library/core/src/hash/mod.rs
  |
  |     fn hash<H: Hasher>(&self, state: &mut H);
  |        ^^^^ ...because method `hash` has generic type parameters

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps