std::thread::thread

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека поддержки конкуренции

Ветви thread (C++11) jthread (C++20) stop_token (C++20) stop_source (C++20) stop_callback (C++20) hardware_destructive_interference_sizehardware_constructive_interference_size (C++17)(C++17) Пространство имён this_thread get_id (C++11) yield (C++11) sleep_for (C++11) sleep_until (C++11) Атомарные типы atomic (C++11) atomic_ref (C++20) atomic_flag (C++11) Инициализация атомарных типов atomic_init (C++11)(устарело в C++20) ATOMIC_VAR_INIT (C++11)(устарело в C++20) ATOMIC_FLAG_INIT (C++11)(устарело в C++20) Функции освобождения для атомарных операций atomic_storeatomic_store_explicit (C++11)(C++11) atomic_loadatomic_load_explicit (C++11)(C++11) atomic_exchangeatomic_exchange_explicit (C++11)(C++11) atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11) atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11) atomic_fetch_subatomic_fetch_sub_explicit (C++11)(C++11) atomic_fetch_andatomic_fetch_and_explicit (C++11)(C++11) atomic_fetch_oratomic_fetch_or_explicit (C++11)(C++11) atomic_fetch_xoratomic_fetch_xor_explicit (C++11)(C++11) atomic_is_lock_free (C++11) atomic_waitatomic_wait_explicit (C++20)(C++20) atomic_notify_one (C++20) atomic_notify_all (C++20)

Функции освобождения для атомарных флагов atomic_flag_test_and_setatomic_flag_test_and_set_explicit (C++11)(C++11) atomic_flag_clearatomic_flag_clear_explicit (C++11)(C++11) atomic_flag_testatomic_flag_test_explicit (C++20)(C++20) atomic_flag_waitatomic_flag_wait_explicit (C++20)(C++20) atomic_flag_notify_one (C++20) atomic_flag_notify_all (C++20) Упорядочивание памяти memory_order (C++11) kill_dependency (C++11) atomic_thread_fence (C++11) atomic_signal_fence (C++11) Взаимное исключение mutex (C++11) recursive_mutex (C++11) shared_mutex (C++17) timed_mutex (C++11) recursive_timed_mutex (C++11) shared_timed_mutex (C++14) Общее управление блокировкой lock_guard (C++11) scoped_lock (C++17) unique_lock (C++11) shared_lock (C++14) defer_lock_ttry_to_lock_tadopt_lock_t (C++11)(C++11)(C++11) lock (C++11) try_lock (C++11) defer_locktry_to_lockadopt_lock (C++11)(C++11)(C++11) once_flag (C++11) call_once (C++11) Условные переменные condition_variable (C++11) condition_variable_any (C++11) notify_all_at_thread_exit (C++11) cv_status (C++11) Семафоры counting_semaphorebinary_semaphore (C++20)(C++20) Защёлки и барьеры latch (C++20) barrier (C++20) Фьючерсы promise (C++11) future (C++11) shared_future (C++11) packaged_task (C++11) async (C++11) launch (C++11) future_status (C++11) future_error (C++11) future_category (C++11) future_errc (C++11)

 

std::thread

Классы-элементы

thread::id

Функции-элементы

thread::thread

thread::~thread

thread::operator=

Наблюдатели

thread::joinable

thread::get_id

thread::native_handle

thread::hardware_concurrency

Операции

thread::join

thread::detach

thread::swap

Функции, не являющиеся элементами

std::swap(std::thread)

 

<tbody> </tbody>

thread();	(1)	(начиная с C++11)
thread( thread&& other );	(2)	(начиная с C++11)
template< class Function, class... Args > explicit thread( Function&& f, Args&&... args );	(3)	(начиная с C++11)
thread(const thread&) = delete;	(4)	(начиная с C++11)

Создает новый объект потока.

Оригинал:

Constructs new thread object.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

1)

Создает новый объект потока, который не представляет собой поток.

Оригинал:

Creates new thread object which does not represent a thread.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

2)

Конструктор перемещения. Создает объект потока, из потока other. После этого вызова other больше не представляет поток выполнения.

Оригинал:

Move constructor. Constructs the thread object to represent the thread of execution that was represented by other. After this call other no longer represents a thread of execution.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

3)

Создает новый объект std::thread и связывает его с потоком выполнения. Первый конструктор копирует все аргументы args... в локальную память потока, как функция:

Оригинал:

Creates new std::thread object and associates it with a thread of execution. First the constructor copies all arguments args... to thread-local storage as if by the function:

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

template <class T>
typename decay<T>::type decay_copy(T&& v) {
    return std::forward<T>(v);
}

Любые исключения, создаются в текущем потоке, а не в новом.

Код, который будет выполняться в новом потоке определяется следующим образом. Обратимся к Nonecopied_args, как t1, t2,..., tN, где N является sizeof...(copied_args)and copied_args is the result of calling decay_copy as defined above. The following code will be run in the new thread:

• Если f является указателем на функцию-член класса T, то она называется. Возвращаемое значение игнорируется. По сути, выполняется следующий код:

  Оригинал:

  If f is pointer to a member function of class T, then it is called. The return value is ignored. Effectively, the following code is executed:

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• (t1.*f)(t2, ..., tN), если тип t1 либо T, ссылка на T или ссылка на тип, производный от T.

  Оригинал:

  (t1.*f)(t2, ..., tN) if the type of t1 is either T, reference to T or reference to type derived from T.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• ((*t1).*f)(t2, ..., tN) иначе.

  Оригинал:

  ((*t1).*f)(t2, ..., tN) otherwise.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• Если N == 1 и f является указателем на объект элемента данных класса, то при обращении к нему. Стоимость объекта игнорируются. По сути, выполняется следующий код:

  Оригинал:

  If N == 1 and f is pointer to a member data object of a class, then it is accessed. The value of the object is ignored. Effectively, the following code is executed:

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• t1.*f если и тип t1 либо T, ссылка на T или ссылка на тип, производный от T.

  Оригинал:

  t1.*f if and the type of t1 is either T, reference to T or reference to type derived from T.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• (*t1).*f иначе.

  Оригинал:

  (*t1).*f otherwise.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• f называется указателем на не являющихся членами функции во всех остальных случаях. Возвращаемое значение игнорируется. По сути, f(t1, t2, ..., tN) выполняется.

  Оригинал:

  f is called as a pointer to a non-member function in all other cases. The return value is ignored. Effectively, f(t1, t2, ..., tN) is executed.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Оригинал:

The code that will be run in the new thread is defined as follows. Обратимся к Nonecopied_args, как t1, t2,..., tN, где N является sizeof...(copied_args)and copied_args is the result of calling decay_copy as defined above. The following code will be run in the new thread:

• Если f является указателем на функцию-член класса T, то она называется. Возвращаемое значение игнорируется. По сути, выполняется следующий код:

  Оригинал:

  If f is pointer to a member function of class T, then it is called. The return value is ignored. Effectively, the following code is executed:

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• (t1.*f)(t2, ..., tN), если тип t1 либо T, ссылка на T или ссылка на тип, производный от T.

  Оригинал:

  (t1.*f)(t2, ..., tN) if the type of t1 is either T, reference to T or reference to type derived from T.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• ((*t1).*f)(t2, ..., tN) иначе.

  Оригинал:

  ((*t1).*f)(t2, ..., tN) otherwise.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• Если N == 1 и f является указателем на объект элемента данных класса, то при обращении к нему. Стоимость объекта игнорируются. По сути, выполняется следующий код:

  Оригинал:

  If N == 1 and f is pointer to a member data object of a class, then it is accessed. The value of the object is ignored. Effectively, the following code is executed:

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• t1.*f если и тип t1 либо T, ссылка на T или ссылка на тип, производный от T.

  Оригинал:

  t1.*f if and the type of t1 is either T, reference to T or reference to type derived from T.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
• (*t1).*f иначе.

  Оригинал:

  (*t1).*f otherwise.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

• f называется указателем на не являющихся членами функции во всех остальных случаях. Возвращаемое значение игнорируется. По сути, f(t1, t2, ..., tN) выполняется.

  Оригинал:

  f is called as a pointer to a non-member function in all other cases. The return value is ignored. Effectively, f(t1, t2, ..., tN) is executed.

  Текст был переведён автоматически используя Переводчик Google.
  Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

4)

Конструктор копирования удалён; объекты не копируемые.

Оригинал:

The copy constructor is deleted; threads are not copyable. No two std::thread objects may represent the same thread of execution.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Параметры

other	—	другой объект потока Оригинал: another thread object to construct this thread object with Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
f	—	Функция для выполнения в новом потоке Оригинал: function to execute in the new thread Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
args...	—	Аргументы функции выполнения Оригинал: arguments to pass to the new function Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Исключения

1-2)

спецификация noexcept:  

noexcept

  

3) std::system_error, если поток не может быть запущен. Исключение может представлять std::errc::resource_unavailable_try_again или другую ошибку, зависящую от конкретной реализации.

Заметки

Аргументы функции потока копируются по значению. Если ссылочный аргумент должен быть передан функции потока, он должен быть обернут (например, с std::ref или std::cref).

Оригинал:

The arguments to the thread function are copied by value. If a reference argument needs to be passed to the thread function, it has to be wrapped (e.g. with std::ref or std::cref).

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Любое возвращаемое значение функции игнорируется. Если функция генерирует исключение, вызывается std::terminate. Используйте std::promise или std::async для проброса возвращаемых значений и исключений в вызывающий поток.

Оригинал:

Any return value from the function is ignored. If the function throws an exception, std::terminate is called. In order to pass return values or exceptions back to the calling thread, std::promise or std::async may be used.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Запустить этот код

#include <iostream>
#include <utility>
#include <thread>
#include <chrono>
#include <functional>
#include <atomic>

void f1(int n)
{
    for(int i=0; i<5; ++i) {
        std::cout << "Thread " << n << " executing\n";
        std::this_thread::sleep_for(std::chrono::milliseconds(10));
    }
}

void f2(int& n)
{
    for(int i=0; i<5; ++i) {
        std::cout << "Thread 2 executing\n";
        ++n;
        std::this_thread::sleep_for(std::chrono::milliseconds(10));
    }
}

int main()
{
    int n = 0;
    std::thread t1; // t1 is not a thread
    std::thread t2(f1, n+1); // pass by value
    std::thread t3(f2, std::ref(n)); // pass by reference
    std::thread t4(std::move(t3)); // t4 is now running f2(). t3 is no longer a thread
    t2.join();
    t4.join();
    std::cout << "Final value of n is " << n << '\n';
}

Возможный вывод:

Thread 1 executing
Thread 2 executing
Thread 1 executing
Thread 2 executing
Thread 1 executing
Thread 2 executing
Thread 1 executing
Thread 2 executing
Thread 1 executing
Thread 2 executing
Final value of n is 5