Compartilhar via


Função when_any (C++ REST SDK)

Cria uma tarefa que será concluída com êxito quando todas as tarefas fornecidas como argumentos forem concluídas com êxito.

Aviso

Este tópico contém informações para o C++ REST SDK 1.0 (codinome "Casablanca").Se você estiver usando uma versão mais recente da página da Web do Codeplex Casablanca, use então a documentação local em http://casablanca.codeplex.com/documentation.

template<    typename _Iterator > auto when_any(    _Iterator_Begin,    _Iterator_End,    const task_options& _TaskOptions = task_options() ) -> decltype (details::_WhenAnyImpl<typename std::iterator_traits<_Iterator>::value_type::result_type, _Iterator>::_Perform(_TaskOptions, _Begin, _End));  template<    typename _Iterator > auto when_any(    _Iterator_Begin,    _Iterator_End,    cancellation_token _CancellationToken ) -> decltype (details::_WhenAnyImpl<typename std::iterator_traits<_Iterator>::value_type::result_type, _Iterator>::_Perform(_CancellationToken._GetImplValue(), _Begin, _End));

Parâmetros

  • _Iterator
    O tipo do iterador de entrada.

  • _Begin
    A posição do primeiro elemento no intervalo de elementos a ser combinada na tarefa resultante.

  • _End
    A posição do primeiro elemento além do intervalo de elementos a ser combinada na tarefa resultante.

  • _TaskOptions

  • _CancellationToken
    O token de cancelamento que controla o cancelamento da tarefa retornada. Se você não fornecer um token de cancelamento, a tarefa resultante receberá o token de cancelamento da tarefa que fez com que ela fosse concluída.

Valor de retorno

Uma tarefa que foi concluída com êxito quando alguma das tarefas de entrada foi concluída com êxito. Se as tarefas de entrada forem do tipo T, a saída dessa função será um task<std::pair<T, size_t>>>, em que o primeiro elemento do par é o resultado da conclusão da tarefa e o segundo elemento é o índice da tarefa que foi concluída. Se as tarefas de entrada forem do tipo void, a saída será um task<size_t>, em que o resultado é o índice de conclusão da tarefa.

Requisitos

Cabeçalho: pplxtasks.h

Namespace: pplx

Consulte também

Referência

Namespace pplx

Conceitos

Paralelismo de tarefa (tempo de execução de simultaneidade)