choice (clase)
Un bloque de mensajería choice es un bloque de varios orígenes y de destino único que representa una interacción del flujo de control con un conjunto de orígenes. El bloque de elección esperará a cualquiera de los orígenes para generar un mensaje y propagará el índice del origen que generó el mensaje.
Sintaxis
template<
class T
>
class choice: public ISource<size_t>;
Parámetros
T
Tipo basado en tuple que representa las cargas de los orígenes de entrada.
Miembros
Definiciones de tipos públicas
| Nombre | Descripción |
|---|---|
type |
Alias de tipo para T. |
Constructores públicos
| Nombre | Descripción |
|---|---|
| choice | Con sobrecarga. Construye un bloque de mensajería choice . |
| Destructor ~choice | Destruye el bloque de mensajería choice. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| accept | Acepta un mensaje ofrecido por este bloque choice y transfiere la propiedad al autor de la llamada. |
| acquire_ref | Adquiere un recuento de referencias en este bloque de mensajería choice para evitar la eliminación. |
| consumo | Consume un mensaje ofrecido previamente por el bloque de mensajería choice y reservado correctamente por el destino, y transfiere la propiedad al autor de la llamada. |
| has_value | Comprueba si este bloque de mensajería choice se ha inicializado con un valor. |
| índice | Devuelve un índice en el tuple para representar el elemento seleccionado por el bloque de mensajería choice. |
| link_target | Enlaza un bloque de destino a este bloque de mensajería choice. |
| release | Libera una reserva de mensajes correcta anterior. |
| release_ref | Libera un recuento de referencias en este bloque de mensajería choice. |
| reserve | Reserva un mensaje ofrecido anteriormente por este bloque de mensajería choice. |
| unlink_target | Desenlaza un bloque de destino de este bloque de mensajería choice. |
| unlink_targets | Desenlaza todos los destinos de este bloque de mensajería choice. (Invalida ISource::unlink_targets.) |
| value | Obtiene el mensaje cuyo índice se ha seleccionado mediante el bloque de mensajería choice. |
Comentarios
El bloque de elección garantiza que solo se consuma uno de los mensajes entrantes.
Para obtener más información, consulte Bloques de mensajes asincrónicos.
Jerarquía de herencia
choice
Requisitos
Encabezado: agents.h
Espacio de nombres: simultaneidad
aceptar
Acepta un mensaje ofrecido por este bloque choice y transfiere la propiedad al autor de la llamada.
virtual message<size_t>* accept(
runtime_object_identity _MsgId,
_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_MsgId
El valor runtime_object_identity del objeto message ofrecido.
_PTarget
Puntero al bloque de destino que está llamando al método accept.
Valor devuelto
Puntero al mensaje que ahora posee el autor de la llamada.
acquire_ref
Adquiere un recuento de referencias en este bloque de mensajería choice para evitar la eliminación.
virtual void acquire_ref(_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_PTarget
Puntero al bloque de destino que llama a este método.
Comentarios
Un objeto ITarget que está vinculado a este origen llama a este método durante el método link_target.
opción
Construye un bloque de mensajería choice .
explicit choice(
T _Tuple);
choice(
Scheduler& _PScheduler,
T _Tuple);
choice(
ScheduleGroup& _PScheduleGroup,
T _Tuple);
choice(
choice&& _Choice);
Parámetros
_Tuple
tuple de orígenes para choice.
_PScheduler
El objeto Scheduler dentro del que se programa la tarea de propagación para el bloque de mensajería choice .
_PScheduleGroup
El objeto ScheduleGroup dentro del que se programa la tarea de propagación para el bloque de mensajería choice . El objeto Scheduler utilizado está implícito en el grupo de programación.
_Choice
Bloque de mensajería choice desde el que se realizará la copia. Tenga en cuenta que el objeto original es huérfano, por lo que este constructor pasa a ser de movimiento.
Comentarios
El runtime usa el programador predeterminado si no se especifican los parámetros _PScheduler o _PScheduleGroup .
La construcción de movimiento no se lleva acabo con un bloqueo, lo que significa que el usuario debe asegurarse de que no hay ninguna tarea ligera en marcha en el momento del movimiento. De lo contrario, se pueden producir numerosas carreras, que darán lugar a excepciones o a un estado incoherente.
~elección
Destruye el bloque de mensajería choice.
~choice();
consumir
Consume un mensaje ofrecido previamente por el bloque de mensajería choice y reservado correctamente por el destino, y transfiere la propiedad al autor de la llamada.
virtual message<size_t>* consume(
runtime_object_identity _MsgId,
_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_MsgId
runtime_object_identity del objeto message reservado.
_PTarget
Puntero al bloque de destino que está llamando al método consume.
Valor devuelto
Puntero al objeto message del que el autor de la llamada tiene ahora la propiedad.
Comentarios
El método consume es similar a accept, pero siempre debe ir precedido de una llamada a reserve que haya devuelto true.
has_value
Comprueba si este bloque de mensajería choice se ha inicializado con un valor.
bool has_value() const;
Valor devuelto
true si el bloque ha recibido un valor; de lo contrario, false.
índice
Devuelve un índice en el tuple para representar el elemento seleccionado por el bloque de mensajería choice.
size_t index();
Valor devuelto
Índice del mensaje.
Comentarios
La carga del mensaje se puede extraer mediante el método get.
link_target
Enlaza un bloque de destino a este bloque de mensajería choice.
virtual void link_target(_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_PTarget
Puntero a un bloque ITarget que se enlazará a este bloque de mensajería choice.
release
Libera una reserva de mensajes correcta anterior.
virtual void release(
runtime_object_identity _MsgId,
_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_MsgId
El valor runtime_object_identity del objeto message que se libera.
_PTarget
Puntero al bloque de destino que está llamando al método release.
release_ref
Libera un recuento de referencias en este bloque de mensajería choice.
virtual void release_ref(_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_PTarget
Puntero al bloque de destino que llama a este método.
Comentarios
Un objeto ITarget que se desenlazará de este origen llama a este método. El bloque de origen se permite para liberar los recursos reservados para el bloque de destino.
reserva
Reserva un mensaje ofrecido anteriormente por este bloque de mensajería choice.
virtual bool reserve(
runtime_object_identity _MsgId,
_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_MsgId
El runtime_object_identity del objeto message que se está reservando.
_PTarget
Puntero al bloque de destino que está llamando al método reserve.
Valor devuelto
true si se ha reservado correctamente el mensaje; de lo contrario, false. Las reservas pueden producir errores por muchas razones, como que el mensaje ya estaba reservado o aceptado por otro destino, que el origen deniegue reservas, etc.
Comentarios
Después de llamar a reserve, si no hay errores, debe llamar a consume o release para tomar la posesión del mensaje o renunciar a ella respectivamente.
unlink_target
Desenlaza un bloque de destino de este bloque de mensajería choice.
virtual void unlink_target(_Inout_ ITarget<size_t>* _PTarget);
Parámetros
_PTarget
Puntero a un bloque ITarget que se desenlazará de este bloque de mensajería choice.
unlink_targets
Desenlaza todos los destinos de este bloque de mensajería choice.
virtual void unlink_targets();
Comentarios
No es necesario llamar a este método desde el destructor porque el destructor del bloque interno single_assignment se desenlazará correctamente.
value
Obtiene el mensaje cuyo índice se ha seleccionado mediante el bloque de mensajería choice.
template <
typename _Payload_type
>
_Payload_type const& value();
Parámetros
_Payload_type
Tipo de carga del mensaje.
Valor devuelto
Carga del mensaje.
Comentarios
Dado que un bloque de mensajería choice puede tomar entradas con diferentes tipos de carga, debe especificar el tipo de carga en la recuperación. Puede determinar el tipo en función del resultado del método index.
Consulte también
concurrency (espacio de nombres)
join (clase)
single_assignment (clase)