Struct fe_osi::semaphore::Semaphore

#[repr(C)]pub struct Semaphore { /* fields omitted */ }

A tool used to prevent data races.

Implementations

impl Semaphore

pub const fn new(start_count: usize) -> Semaphore

Creates a Semaphore with a specified starting count.

pub const fn new_mutex() -> Semaphore

Creates a mutex Semaphore. Usually used for locking

pub fn is_available(&self) -> bool

Returns true if the Semaphore can be taken, false otherwise.

pub fn take(&self)

Takes a Semaphore for a task. If the Semaphore cannot be taken right away, block until it can be taken.

pub fn try_take(&self) -> bool

Attempt to take the Semaphore. If the Semaphore is taken, return true. Otherwise, return false.

pub fn give(&self)

In a mutex Semaphore, give() sets the count to 1. In a non-mutex Semaphore, gives increments the count by 1.

pub fn with_lock<F: FnMut()>(&self, f: F)

Takes the Semaphore, executes the closure, then gives the Semaphore.

pub fn try_with_lock<F: FnMut()>(&self, f: F) -> bool

Attempts to take the Semaphore. If it succeeds, execute the closure, return true, then give back the Semaphore. Otherwise, it will return false.