Mistake on this page?
Report an issue in GitHub or email us
Public Member Functions
Mutex Class Reference

The Mutex class is used to synchronize the execution of threads. More...

#include <Mutex.h>

Inheritance diagram for Mutex:
NonCopyable< Mutex >

Public Member Functions

 Mutex ()
 Create and Initialize a Mutex object. More...
 
 Mutex (const char *name)
 Create and Initialize a Mutex object. More...
 
void lock ()
 Wait until a Mutex becomes available. More...
 
bool trylock ()
 Try to lock the mutex, and return immediately. More...
 
bool trylock_for (uint32_t millisec)
 Try to lock the mutex for a specified time. More...
 
bool trylock_for (Kernel::Clock::duration_u32 rel_time)
 Try to lock the mutex for a specified time. More...
 
bool trylock_until (uint64_t millisec)
 Try to lock the mutex until specified time. More...
 
bool trylock_until (Kernel::Clock::time_point abs_time)
 Try to lock the mutex until specified time. More...
 
void unlock ()
 Unlock the mutex that has previously been locked by the same thread. More...
 
osThreadId_t get_owner ()
 Get the owner the this mutex. More...
 
 ~Mutex ()
 Mutex destructor. More...
 

Detailed Description

The Mutex class is used to synchronize the execution of threads.

This is, for example, used to protect access to a shared resource.

In bare-metal builds, the Mutex class is a dummy, so lock() and unlock() are no-ops.

Note
You cannot use member functions of this class in ISR context. If you require Mutex functionality within ISR handler, consider using Semaphore.
Memory considerations: The mutex control structures are created on the current thread's stack, both for the Mbed OS and underlying RTOS objects (static or dynamic RTOS memory pools are not being used).

Definition at line 70 of file Mutex.h.

Member Function Documentation

osThreadId_t get_owner ( )

Get the owner the this mutex.

Returns
the current owner of this mutex.
Note
You cannot call this function from ISR context.
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.