std::promise::set_value
De cppreference.com
<tbody>
</tbody>
void set_value( const R& value ); |
(1) | (solo miembro de la plantilla genérica promise)(desde C++11) |
void set_value( R&& value ); |
(2) | (solo miembro de la plantilla genérica promise)(desde C++11) |
void set_value( R& value ); |
(3) | (solo miembro de la especialización de plantilla promise<R&>)(desde C++11) |
void set_value(); |
(4) | (solo miembro de la especialización de plantilla promise<void>)(desde C++11) |
1-3) Atómicamente almacena el valor
value en el estado compartido y deja el estado listo. 4) Deja el estado listo.
Esta operación se comporta como si set_value, set_exception, set_value_at_thread_exit, y set_exception_at_thread_exit tomaran posesión de un solo mutex asociado con el objeto promesa mientras se actualiza el objeto promesa.
Se lanza una excepción si no hay un estado compartido o si el estado compartido ya almacena un valor o excepción.
Las llamadas a esta función no introducen carreras de datos con llamadas a get_future (por lo tanto no necesitan sincronizarse entre sí).
Parámetros
| value | - | El valor a almacenar en el estado compartido. |
Valor de retorno
(Ninguno)
Excepciones
std::future_error en las siguientes condiciones:
*thisno tiene un estado compartido. El código de error se establece a no_state.
- El estado compartido ya almacena un valor o una excepción. El código de error se establece a promise_already_satisfied.
Adicionalmente:
1, 3) Cualquier excepción lanzada por el constructor de copia de
value.2) Cualquier excepción lanzada por el constructor de movimiento de
value.Ejemplo
Este ejemplo muestra cómo objetos promise<void> pueden usarse como señales entre hilos.
Ejecuta este código
#include <thread>
#include <future>
#include <cctype>
#include <vector>
#include <algorithm>
#include <iterator>
#include <iostream>
#include <sstream>
int main()
{
std::istringstream iss_numbers{"3 4 1 42 23 -23 93 2 -289 93"};
std::istringstream iss_letters{" a 23 b,e a2 k k?a;si,ksa c"};
std::vector<int> numbers;
std::vector<char> letters;
std::promise<void> numbers_promise, letters_promise;
auto numbers_ready = numbers_promise.get_future();
auto letter_ready = letters_promise.get_future();
std::thread value_reader([&]
{
// Operaciones de E/S.
std::copy(std::istream_iterator<int>{iss_numbers},
std::istream_iterator<int>{},
std::back_inserter(numbers));
// Notificar para números.
numbers_promise.set_value();
std::copy_if(std::istreambuf_iterator<char>{iss_letters},
std::istreambuf_iterator<char>{},
std::back_inserter(letters),
::isalpha);
// Notificar para letras.
letters_promise.set_value();
});
numbers_ready.wait();
std::sort(numbers.begin(), numbers.end());
if (letter_ready.wait_for(std::chrono::seconds(1)) ==
std::future_status::timeout)
{
// Imprime los números mientras se obtienen las letras.
for (int num : numbers) std::cout << num << ' ';
numbers.clear(); // Los números ya se imprimieron.
}
letter_ready.wait();
std::sort(letters.begin(), letters.end());
// Si los números ya se imprimieron, no hace nada.
for (int num : numbers) std::cout << num << ' ';
std::cout << '\n';
for (char let : letters) std::cout << let << ' ';
std::cout << '\n';
value_reader.join();
}
Salida:
-289 -23 1 2 3 4 23 42 93 93
a a a a b c e i k k k s s
Véase también
| Establece el resultado para indicar una excepción. (función miembro pública) |
