Docs › API references and tutorials › Scheduling: RTOS and event handling › RTOS APIs › ThisThread

ThisThread

Use the ThisThread class to control the current thread.

Unlike the Thread API, which allows you to create, join and end threads, ThisThread lets you control the thread that's currently running. A thread may not have a corresponding Mbed Thread object because you can create a thread directly with CMSIS-RTOS APIs, or it might be main's thread. You can't manipulate those with Thread methods, but ThisThread functions still work from inside them.

ThisThread class reference

rtos::ThisThread Namespace Reference

ThisThread example

Spawn a thread to blink for 5 seconds before setting a flag to trigger the thread to terminate.

main.cpp

#include "mbed.h"
#include "rtos.h"

#define STOP_FLAG 1

// Toggles LED
void blink(DigitalOut *led)
{
    // Toggle the LED every second, until the STOP_FLAG is set
    while (!ThisThread::flags_wait_any_for(STOP_FLAG, 1s)) {
        *led = !*led;
    }
}

// Creates a thread to toggle an LED for 5 seconds
int main()
{
    Thread thread;
    DigitalOut led1(LED1);
    thread.start(callback(blink, &led1));
    // Pause the main thread for 5 seconds
    ThisThread::sleep_for(5s);
    // Set the flag checked by the thread to stop the loop
    thread.flags_set(STOP_FLAG);
    // Wait for the thread to terminate
    thread.join();
}

Thread API reference.

ThisThread

ThisThread class reference

ThisThread example

Related content

Important Information for this Arm website