std::thread::native_handle

native_handle_type native_handle();		(since C++11)

Returns the implementation defined underlying thread handle.

Parameters

(none)

Return value

implementation defined handle type representing the thread.

Exceptions

(none)

Example

Uses native_handle to enable realtime scheduling of C++ threads on a POSIX system

Run this code

#include <thread>
#include <mutex>
#include <iostream>
#include <chrono>
#include <cstring>
#include <pthread.h>

std::mutex iomutex;
void f(int num)
{
    std::this_thread::sleep_for(std::chrono::seconds(1));

    sched_param sch;
    int policy; 
    pthread_getschedparam(pthread_self(), &policy, &sch);
    std::lock_guard<std::mutex> lk(iomutex);
    std::cout << "Thread " << num << " is executing at priority "
              << sch.sched_priority << '\n';
}

int main()
{
    std::thread t1(f, 1), t2(f, 2);

    sched_param sch;
    int policy; 
    pthread_getschedparam(t1.native_handle(), &policy, &sch);
    sch.sched_priority = 20;
    if (pthread_setschedparam(t1.native_handle(), SCHED_FIFO, &sch)) {
        std::cout << "Failed to setschedparam: " << std::strerror(errno) << '\n';
    }

    t1.join(); t2.join();
}

Output:

Thread 2 is executing at priority 0
Thread 1 is executing at priority 20

Language
Headers
Freestanding and hosted implementations
Named requirements
Language support library
Concepts library (C++20)
Diagnostics library
Utilities library
Strings library
Containers library
Algorithms library
Iterators library
Numerics library
Input/output library
Localizations library
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)
Filesystem library (C++17)
Technical Specifications

Member classes
thread::id
Member functions
thread::thread
thread::~thread
thread::operator=
Observers
thread::joinable
thread::get_id
thread::native_handle
thread::hardware_concurrency
Operations
thread::join
thread::detach
thread::swap
Non-member functions
std::swap