std::thread::thread

This page has been machine-translated from the English version of the wiki using Google Translate.

The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

Click here for the English version of this page

Biblioteca de suporte a discussão

Threads

thread

(C++11)

this_thread namespace

get_id (C++11)
yield (C++11)

sleep_for (C++11)
sleep_until (C++11)

Exclusão mútua

mutex (C++11)
timed_mutex (C++11)

recursive_mutex (C++11)
recursive_timed_mutex (C++11)

Gestão de bloqueio genérico

lock_guard (C++11)
unique_lock (C++11)
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)

Variáveis de condição

condition_variable

(C++11)

condition_variable_any

(C++11)

notify_all_at_thread_exit

(C++11)

cv_status

(C++11)

Futuros

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)

Aulas-Membros

Funções de membro

Observadores

thread::native_handle

thread::hardware_concurrency

Operações

Não-membros funções


`thread();`	(1)	(desde C++11)

`thread( thread&& other );`	(2)	(desde C++11)

`template< class Function, class... Args > explicit thread( Function&& f, Args&&... args );`	(3)	(desde C++11)

`thread(const thread&) = delete;`	(4)	(desde C++11)

Constrói objeto novo segmento.

1)

Cria objeto novo segmento que não representa um fio.

2)

Mova construtor. Constrói o objeto de discussão para representar o segmento de execução que foi representada por other. Após esta chamada other já não representa um fio de execução.

3)

Cria novo std::thread objeto e associa-lo com um fio de execução. Primeiro o construtor copia todos args... argumentos para segmento local de armazenamento como se pela função:

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

@ @ As exceções lançadas durante a avaliação e cópia dos argumentos são jogados no segmento atual não, o novo segmento.

@ @ O código que será executado no novo segmento é definido como segue. Vamos referir a Nonecopied_args como t1, t2,..., tN, onde 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:

Se f é ponteiro para uma função membro de T classe, então ele é chamado. O valor de retorno é ignorado. Efetivamente, o seguinte código é executado:
Original:
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:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

(t1.*f)(t2, ..., tN) se o tipo de t1 é ou T, a referência a T ou referência ao tipo derivado de T.
Original:
(t1.*f)(t2, ..., tN) if the type of t1 is either T, reference to T or reference to type derived from T.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
((*t1).*f)(t2, ..., tN) de outra forma.
Original:
((*t1).*f)(t2, ..., tN) otherwise.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Se N == 1 e f é ponteiro para um objeto de dados membro de uma classe, então ela é acessada. O valor do objeto é ignorado. Efetivamente, o seguinte código é executado:
Original:
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:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

t1.*f se e o tipo de t1 é ou T, a referência a T ou referência ao tipo derivado de T.
Original:
t1.*f if and the type of t1 is either T, reference to T or reference to type derived from T.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
(*t1).*f de outra forma.
Original:
(*t1).*f otherwise.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

f é chamado como um ponteiro para uma função não-membro em todos os outros casos. O valor de retorno é ignorado. Efectivamente, é executado f(t1, t2, ..., tN).
Original:
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.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

4)

O construtor de cópia é apagado; tópicos não são copiável. Não há duas std::thread objetos podem representar o mesmo segmento de execução.

Parâmetros

other	-	outro objeto de discussão para construir este objeto de discussão com Original: another thread object to construct this thread object with The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
f	-	função para executar no novo segmento Original: function to execute in the new thread The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
args...	-	argumentos para passar para a nova função Original: arguments to pass to the new function The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

Exceções

1-2)

noexcept specification:


`noexcept`

(desde C++11)

3)

std::system_error se o segmento não pôde ser iniciado. A exceção pode representar a std::errc::resource_unavailable_try_again condição de erro ou outra condição de erro aplicação específica.

Notas

Os argumentos para a função segmento são copiados por valor. Se um argumento de referência tem de ser passado para a função de rosca, que tem que ser envolvida (por exemplo, com ou std::ref std::cref).

Qualquer valor de retorno da função é ignorado. Se a função lança uma exceção, std::terminate é chamado. A fim de passar valores de retorno ou exceções de volta para a chamada linha std::promise, ou std::async pode ser usado.

Exemplo

#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';
}

Potencial saída:

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

Suporte ao Compilador
Freestanding and hosted
Linguagem
Headers da Biblioteca Standard
Requerimentos nomeados
Feature test macros (C++20)
Biblioteca de suporte de língua
Biblioteca de conceitos (C++20)
Biblioteca de diagnósticos
Biblioteca de utilitários em geral
Biblioteca de strings
Biblioteca de containers
Ranges library (C++20)
Biblioteca de iteradores
Biblioteca de algorítmos
Biblioteca numérica
Biblioteca de localizações
Biblioteca de input/output
Biblioteca de sistema de arquivo (C++17)
Biblioteca de expressões regulares (C++11)
Biblioteca de operações atômicas (C++11)
Biblioteca de suporte de thread (C++11)
Especificações Técnicas
Índice de symbolos
Bibliotecas externas

cppreference.com

Procurar

Espaços nominais

Variantes

Visualizações

Ações

std::thread::thread

Índice

Parâmetros

Exceções

Notas

Exemplo

Navegação

Ferramentas