<future>

Inclua o cabeçalho padrão <future> para definir modelos de classes e suporte que simplificam a execução de uma função — possivelmente em um thread separado — e a recuperação de seu resultado. O resultado é o valor retornado pela função ou uma exceção que é emitida pela função, mas não é capturada na função.

Esse cabeçalho usa ConcRT (Runtime de Simultaneidade) para que você possa usá-lo juntamente com outros mecanismos ConcRT. Para obter mais informações sobre o ConcRT, consulte Runtime de simultaneidade.

Sintaxe

#include <future>

Comentários

Um provedor assíncrono armazena o resultado de uma chamada de função. Um objeto de retorno assíncrono é usado para recuperar o resultado de uma chamada de função. Um estado assíncrono associado fornece comunicação entre um provedor assíncrono e um ou mais objetos de retorno assíncronos.

Um programa não cria diretamente nenhum objetos de estado assíncrono associado. O programa cria um provedor assíncrono sempre que precisa de um e, por meio dele, cria um objeto de retorno assíncrono que compartilha seu estado assíncrono associado com o provedor. Provedores assíncronos e objetos de retorno assíncronos gerenciam os objetos que mantêm seu estado assíncrono associado compartilhado. Quando o último objeto que faz referência ao estado assíncrono associado o libera, o objeto que contém o estado assíncrono associado é destruído.

Um provedor assíncrono ou um objeto de retorno assíncrono sem nenhum estado assíncrono associado fica vazio.

Um estado assíncrono associado ficará pronto somente se seu provedor assíncrono tiver armazenado um valor retornado ou armazenado uma exceção.

A função de modelo async e os modelos de classe promise e packaged_task são provedores assíncronos. Os modelos de classe future e shared_future descrevem objetos de retorno assíncronos.

Cada um desses modelos de classe promise, future e shared_future tem uma especialização para o tipo void e uma especialização parcial para armazenar e recuperar um valor por referência. Essas especializações diferem do modelo primário somente quanto às assinaturas e à semântica das funções que armazenam e recuperam o valor retornado.

Os modelos de classe future e shared_future nunca bloqueiam seus destruidores, exceto em um caso que é preservado para compatibilidade com versões anteriores: diferente de todos os outros futures, para um future — ou para o último shared_future — anexado a uma tarefa iniciada com std::async, o destruidor é bloqueado se a tarefa não tiver sido concluída, ou seja, ele é bloqueado se o thread ainda não tiver chamado .get() ou .wait() e a tarefa ainda estiver em execução. A seguinte nota de usabilidade foi adicionada à descrição do rascunho do padrão: "[Nota: Se um futuro obtido de std::async for movido para fora do escopo local, outro código que usa o futuro deve estar ciente de std::async que o destruidor do futuro pode bloquear para que o estado compartilhado fique pronto.—nota final]" Em todos os outros casos, future e shared_future destruidores são necessários e têm a garantia de nunca bloquear.

Membros

Classes

Estruturas

Funções

Enumerações

Confira também

Referência de Arquivos de Cabeçalho