rsevents-extra

Crates.iorsevents-extra
lib.rsrsevents-extra
version0.2.2
sourcesrc
created_at2018-09-29 00:49:41.657694
updated_at2023-04-30 20:50:56.410141
descriptionSynchronization objects built on top of rsevents. Semaphore, countdown event, and more.
homepagehttps://github.com/neosmart/rsevents-extra
repositoryhttps://github.com/neosmart/rsevents-extra
max_upload_size
id87067
size42,791
Mahmoud Al-Qudsi (mqudsi)

documentation

https://docs.rs/rsevents-extra/latest/rsevents_extra/

README

rsevents-extra

crates.io docs.rs

rsevents-extra is a utility crate with a number of useful synchronization "primitives" built on top of (and therefore, at a higher level than) rsevents. rsevents-extra is a community project, feel free to contribute additional synchronization objects to this crate!

About rsevents

Please refer to the rsevents README and documentation to learn more about rsevents, the library that this crate is built on top of. At its core, rsevents is a low-level signalling and synchronization library, mimicking the behavior of the WIN32 auto- and manual-reset events, and can be useful to add lightweight and performant synchronization to programs where the needs do not strictly align with the concepts of mutexes or critical sections.

This crate includes some additional synchronization types built on top of the core events in the rsevents library.

Utility events included in this crate

This crate contains implementations of the following events:

  • Countdown Event
  • Semaphore

Countdown Event

A countdown event is a useful synchronization tool for spawning tasks and checking on their completion status. A CountdownEvent object is instantiated with a count, and upon each call to CountdownEvent::tick(), the internal count is decremented. A waiter can call CountdownEvent::wait() (or any of the other wait routines exposed by the Awaitable trait) to block efficiently until the countdown reaches zero. Once the internal countdown reaches zero, the event becomes set and waiters are woken/notified and the event remains set until a call to CountdownEvent::reset() is made.

Semaphore

A semaphore is a synchronization primitive used to limit concurrency or concurrent access to a particular resource or region. A semaphore created with Semaphore::new() is assigned both a maximum concurrency and an initial concurrency (up to the maximum). Threads obtain a concurrency token by calling Semaphore::wait(), which reserves them a slot to access the concurrency-limited region until the concurrency token is dropped at the end of the scope. If more threads attempt to obtain access to a semaphore-protected region, their calls to Semaphore::wait() will block (while they efficiently sleep) until another thread drops its concurrency token or the semaphore's concurrency limit is increased.

Commit count: 48

cargo fmt