Crates.io | splitrc |
lib.rs | splitrc |
version | 0.1.11 |
source | src |
created_at | 2023-11-04 04:39:13.979179 |
updated_at | 2024-06-26 06:02:49.933638 |
description | Thread-Safe Split Reference Counts |
homepage | |
repository | https://github.com/chadaustin/splitrc |
max_upload_size | |
id | 1024965 |
size | 26,928 |
splitrc provides a pair of reference counts that together manage the lifetime of an object. The object is notified when either half's count reaches zero.
It is primarily aimed at implementing ownership of channel types, where the channel needs notification when one half is fully dropped.
The implementation stores two 32-bit counters in a shared 64-bit atomic. On 64-bit platforms, atomic increment and decrements are used. On 32-bit platforms, increments and decrements are a CAS loop.
Four billion references should be plenty. Exceeding that leads to a panic.
The pointers are arbitrarily named [Tx] and [Rx] to indicate their intended use by channels.
# struct MyValue {}
# impl splitrc::Notify for MyValue {}
let (tx, rx) = splitrc::new(MyValue {});