std::jthread::hardware_concurrency

From cppreference.com
< cpp‎ | thread‎ | jthread

 
 
Concurrency support library
Threads
(C++11)
(C++20)
(C++20)
this_thread namespace
(C++11)
(C++11)
(C++11)
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
Free functions for atomic operations
Free functions for atomic flags
Memory ordering
Mutual exclusion
(C++11)
Generic lock management
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Condition variables
(C++11)
Semaphores
Latches and barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
 
 
[[nodiscard]] static unsigned int hardware_concurrency() noexcept;
(since C++20)

Returns the number of concurrent threads supported by the implementation. The value should be considered only a hint.

Parameters

(none)

Return value

Number of concurrent threads supported. If the value is not well defined or not computable, returns 0.

Example

#include <iostream>
#include <thread>
 
int main() {
    unsigned int n = std::jthread::hardware_concurrency();
    std::cout << n << " concurrent threads are supported.\n";
}

Possible output:

4 concurrent threads are supported.

See also

min offset to avoid false sharing
max offset to promote true sharing
(constant)