Struct PhaserReadLock

pub struct PhaserReadLock { /* private fields */ }

Guard struct for a WriterReaderPhaser that allows a reader to perform a “phase flip”.

The PhaserReadLock struct allows one to perform a “phase flip” on its parent WriterReaderPhaser. It is held in a std::sync::Mutex in its parent phaser, enforcing that only one reader may be active at once.

The flip_phase call performs a spin-wait while waiting the the currently-active writers to finish. A sleep time may be added between checks by calling flip_with_sleep instead.

Example

{
    let lock = phaser.read_lock().unwrap();
    // swap buffers
    lock.flip_phase();
    // reader now has access to a stable snapshot
} // lock drops, relinquishing the read lock and allowing another reader to lock

Implementations

impl PhaserReadLock

pub fn flip_phase(&self)

Wait until all currently-active writer critical sections have completed.

pub fn flip_with_sleep(&self, sleep_time: Duration)

Wait until all currently-active writer critical sections have completed. While waiting, sleep with the given duration.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes