Mutex

Inherits: Reference < Object

Category: Core

Brief Description

A synchronization Mutex.

Member Functions

void lock ( )
int try_lock ( )
void unlock ( )

Description

A synchronization Mutex. Element used to synchronize multiple Threads. Basically a binary Semaphore. Guarantees that only one thread can ever acquire this lock at a time. Can be used to protect a critical section. Be careful to avoid deadlocks.

Member Function Description

  • void lock ( )

Lock this Mutex, blocks until it is unlocked by the current owner.

  • int try_lock ( )

Try locking this Mutex, does not block. Returns OK on success, ERR_BUSY otherwise.

  • void unlock ( )

Unlock this Mutex, leaving it to other threads.