std::thread::thread — cppreference.com

Материал из cppreference.com

`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.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

Creates new thread object which does not represent a thread.

Конструктор перемещения. Создает объект потока, из потока 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.

Создает новый объект 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:

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.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

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

Параметры

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. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Исключения

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).

Любое возвращаемое значение функции игнорируется. Если функция генерирует исключение, вызывается 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.

Пример

#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

Категории: