std::jthread::get_id(3)

💖 std::jthread::get_id(3) 💖

okay so welcome to the std::jthread::get_id(3) page from the C++ Standard Libary manual, bestie. this one is short, it’s giving “tiny but mighty,” and we’re gonna get you all the way together. 💅

🌸 NAME 🌸

std::jthread::get_id — literally std::jthread::get_id, no cap. that’s the whole name, and she ate.

✨ Synopsis ✨

here’s the signature, bestie — copy it exactly, [[nodiscard]] and all:

[[nodiscard]] std::jthread::id get_id() const noexcept;

(since C++20)

so yeah: it returns a value of std::jthread::id — which is a type alias for std::thread::id — identifying the thread associated with *this. iykyk. 🦋

🎀 Parameters 🎀

none. (none). zero. no arguments, no drama. 🙈

💜 Return value 💜

a value of type std::jthread::id identifying the thread associated with *this. if there is no thread associated, a default constructed std::jthread::id is returned. that’s the whole tea. 🍓

🔥 Example 🔥

// Run this code — here’s the example, verbatim:

#include <chrono>
#include <iostream>
#include <thread>

void foo()
{
    std::this_thread::sleep_for(std::chrono::seconds(1));
}

int main()
{
    std::jthread t1(foo);
    std::jthread::id t1_id = t1.get_id();

    std::jthread t2(foo);
    std::jthread::id t2_id = t2.get_id();

    std::cout << "t1's id: " << t1_id << '\n';
    std::cout << "t2's id: " << t2_id << '\n';

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

    std::cout << "t1's id after join: " << t1.get_id() << '\n';
    std::cout << "t2's id after join: " << t2.get_id() << '\n';
}

Possible output:

t1's id: 140146221688576
t2's id: 140146213295872
t1's id after join: thread::id of a non-executing thread
t2's id after join: thread::id of a non-executing thread

🌈 See also 🌈

• id — represents the id of a thread (public member class of std::thread)
• checks whether the thread is joinable, i.e. potentially running in parallel
• joinable context — (public member function)

mwah 💋 sign-off time: source/version: http://cppreference.com; date/version: 2024.06.10; page: std::jthread::get_id(3). periodt. 👑