std::promise::set_value
De cppreference.com
| 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í).
Contenido |
[editar] Parámetros
| value | - | El valor a almacenar en el estado compartido. |
[editar] Valor de retorno
(Ninguno)
[editar] Excepciones
std::future_error en las siguientes condiciones:
- *this no 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.[editar] 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
[editar] Véase también
| Establece el resultado para indicar una excepción. (función miembro pública) |
