Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mbrubeck/by_address

Rust wrapper type that implements hashing and comparison by pointer address
https://github.com/mbrubeck/by_address

Last synced: about 1 month ago
JSON representation

Rust wrapper type that implements hashing and comparison by pointer address

Awesome Lists containing this project

README

        

# by_address

Rust wrapper type that implements hashing and comparison based on address
rather than value.

* [API Documentation](https://docs.rs/by_address)
* [crates.io package](https://crates.io/crates/by_address)
* [Source code](https://github.com/mbrubeck/by_address)

# Overview

`ByAddress` can be used to wrap any pointer type (i.e. any type that implements the Deref
trait). This includes references, raw pointers, smart pointers like `Rc`
and `Box`, and specialized pointer-like types such as `Vec` and `String`.

The wrapped pointer implements the following traits based on the address of
its contents, rather than their value:

* Hash
* Eq, PartialEq
* Ord, PartialOrd

## no_std

This crate does not depend on libstd, so it can be used in [`no_std`]
projects.

[`no_std`]: https://doc.rust-lang.org/book/first-edition/using-rust-without-the-standard-library.html

## Release notes

### Version 1.2.1

* Mark `ByThinAddress` as `repr(transparent)`.

### Version 1.2.0

* Add `from_ref` constructor.

### Version 1.1.2

* Improved documentations.

### Version 1.1.1

* Update to Rust 2021.

### Version 1.1.0

* New `ByThinAddress` type.
* Implement the `Display` trait.
* Custom implementation of `Debug` that includess the pointer address.

### Version 1.0.4

* Improve hashing of fat pointers

### Version 1.0.3

* Implement `From` for `ByAddress`
* More documentation fixes

### Version 1.0.2

* More documentation fixes

### Version 1.0.1

* Improved documentation

### Version 1.0.0

* Initial release

## License

Licensed under the Apache License, Version 2.0 or the MIT license, at your
option. See the license files in this directory for details.