Condividi tramite


Classe choice

Un blocco della messaggistica choice è un blocco multi-origine a destinazione singola che rappresenta un'interazione del flusso di controllo con un set di origini. Il blocco choice attenderà che una qualsiasi delle molteplici origini produca un messaggio e propagherà l'indice dell'origine che ha prodotto il messaggio.

Sintassi

template<
    class T
>
class choice: public ISource<size_t>;

Parametri

T
Tipo tuplebasato su che rappresenta i payload delle origini di input.

Membri

Typedef pubblici

Nome Descrizione
type Alias di tipo per T.

Costruttori pubblici

Nome Descrizione
choice Con overload. Costruisce un blocco della messaggistica choice .
Distruttore ~choice Elimina definitivamente il choice blocco di messaggistica.

Metodi pubblici

Nome Descrizione
accettare Accetta un messaggio offerto da questo choice blocco, trasferendo la proprietà al chiamante.
acquire_ref Acquisisce un conteggio dei riferimenti su questo choice blocco di messaggistica per impedire l'eliminazione.
utilizzare Utilizza un messaggio offerto in precedenza da questo choice blocco di messaggistica e riservato correttamente dalla destinazione, trasferendo la proprietà al chiamante.
has_value Controlla se questo choice blocco di messaggistica è stato inizializzato con un valore ancora.
index Restituisce un indice nell'oggetto tuple che rappresenta l'elemento selezionato dal choice blocco di messaggistica.
link_target Collega un blocco di destinazione a questo choice blocco di messaggistica.
release Rilascia una prenotazione di messaggi con esito positivo precedente.
release_ref Rilascia un conteggio dei riferimenti su questo choice blocco di messaggistica.
reserve Riserva un messaggio offerto in precedenza da questo choice blocco di messaggistica.
unlink_target Scollega un blocco di destinazione da questo choice blocco di messaggistica.
unlink_targets Scollega tutte le destinazioni da questo choice blocco di messaggistica. (sostituzioni )ISource::unlink_targets.)
value Ottiene il messaggio il choice cui indice è stato selezionato dal blocco di messaggistica.

Osservazioni:

Il blocco di scelta garantisce che venga utilizzato solo uno dei messaggi in arrivo.

Per altre informazioni, vedere Blocchi di messaggi asincroni.

Gerarchia di ereditarietà

ISource

choice

Requisiti

Intestazione: agents.h

Spazio dei nomi: Concurrency

accept

Accetta un messaggio offerto da questo choice blocco, trasferendo la proprietà al chiamante.

virtual message<size_t>* accept(
    runtime_object_identity _MsgId,
    _Inout_ ITarget<size_t>* _PTarget);

Parametri

_MsgId
Oggetto runtime_object_identity dell'oggetto offerto message .

_PTarget
Puntatore al blocco di destinazione che chiama il accept metodo .

Valore restituito

Puntatore al messaggio di cui il chiamante ha ora la proprietà.

acquire_ref

Acquisisce un conteggio dei riferimenti su questo choice blocco di messaggistica per impedire l'eliminazione.

virtual void acquire_ref(_Inout_ ITarget<size_t>* _PTarget);

Parametri

_PTarget
Puntatore al blocco di destinazione che chiama questo metodo.

Osservazioni:

Questo metodo viene chiamato da un ITarget oggetto collegato a questa origine durante il link_target metodo .

scelta

Costruisce un blocco della messaggistica choice .

explicit choice(
    T _Tuple);

choice(
    Scheduler& _PScheduler,
    T _Tuple);

choice(
    ScheduleGroup& _PScheduleGroup,
    T _Tuple);

choice(
    choice&& _Choice);

Parametri

_Tupla
Oggetto tuple delle origini per choice.

_PScheduler
Oggetto Scheduler all'interno del quale è pianificata l'attività di propagazione per il blocco della messaggistica choice .

_PScheduleGroup
Oggetto ScheduleGroup all'interno del quale è pianificata l'attività di propagazione per il blocco della messaggistica choice . L'oggetto Scheduler usato è previsto dal gruppo di pianificazione.

_Scelta
Blocco della messaggistica choice da cui copiare. Si noti che l'oggetto originale è orfano, si tratta quindi di un costruttore di spostamento.

Osservazioni:

Se non si specificano i parametri _PScheduler o _PScheduleGroup , il runtime usa l'utilità di pianificazione predefinita.

Il costruttore di spostamento non viene eseguito durante un blocco. Ciò significa che l'utente deve assicurarsi che non ci siano attività leggere in corso al momento dello spostamento. In caso contrario, possono verificarsi situazioni di race condition che possono portare a eccezioni oppure a uno stato incoerente.

~scelta

Elimina definitivamente il choice blocco di messaggistica.

~choice();

consume

Utilizza un messaggio offerto in precedenza da questo choice blocco di messaggistica e riservato correttamente dalla destinazione, trasferendo la proprietà al chiamante.

virtual message<size_t>* consume(
    runtime_object_identity _MsgId,
    _Inout_ ITarget<size_t>* _PTarget);

Parametri

_MsgId
Oggetto runtime_object_identity dell'oggetto riservato message .

_PTarget
Puntatore al blocco di destinazione che chiama il consume metodo .

Valore restituito

Puntatore all'oggetto message di cui il chiamante ha ora la proprietà.

Osservazioni:

Il consume metodo è simile a accept, ma deve essere sempre preceduto da una chiamata a reserve che ha restituito true.

has_value

Controlla se questo choice blocco di messaggistica è stato inizializzato con un valore ancora.

bool has_value() const;

Valore restituito

true se il blocco ha ricevuto un valore, false in caso contrario.

index

Restituisce un indice nell'oggetto tuple che rappresenta l'elemento selezionato dal choice blocco di messaggistica.

size_t index();

Valore restituito

Indice del messaggio.

Osservazioni:

Il payload del messaggio può essere estratto usando il get metodo .

Collega un blocco di destinazione a questo choice blocco di messaggistica.

virtual void link_target(_Inout_ ITarget<size_t>* _PTarget);

Parametri

_PTarget
Puntatore a un ITarget blocco da collegare a questo choice blocco di messaggistica.

release

Rilascia una prenotazione di messaggi con esito positivo precedente.

virtual void release(
    runtime_object_identity _MsgId,
    _Inout_ ITarget<size_t>* _PTarget);

Parametri

_MsgId
Oggetto runtime_object_identity dell'oggetto message da rilasciare.

_PTarget
Puntatore al blocco di destinazione che chiama il release metodo .

release_ref

Rilascia un conteggio dei riferimenti su questo choice blocco di messaggistica.

virtual void release_ref(_Inout_ ITarget<size_t>* _PTarget);

Parametri

_PTarget
Puntatore al blocco di destinazione che chiama questo metodo.

Osservazioni:

Questo metodo viene chiamato da un ITarget oggetto che viene scollegato da questa origine. Il blocco di origine può rilasciare tutte le risorse riservate per il blocco di destinazione.

reserve

Riserva un messaggio offerto in precedenza da questo choice blocco di messaggistica.

virtual bool reserve(
    runtime_object_identity _MsgId,
    _Inout_ ITarget<size_t>* _PTarget);

Parametri

_MsgId
Oggetto runtime_object_identity dell'oggetto message riservato.

_PTarget
Puntatore al blocco di destinazione che chiama il reserve metodo .

Valore restituito

true se il messaggio è stato riservato correttamente, false in caso contrario. Le prenotazioni possono avere esito negativo per vari motivi, ad esempio: il messaggio era già riservato o accettato da un'altra destinazione, le prenotazioni potrebbero essere negate dall'origine e così via.

Osservazioni:

Dopo aver chiamato reserve, se ha esito positivo, è necessario chiamare consume o release per accettare o rinunciare rispettivamente al possesso del messaggio.

Scollega un blocco di destinazione da questo choice blocco di messaggistica.

virtual void unlink_target(_Inout_ ITarget<size_t>* _PTarget);

Parametri

_PTarget
Puntatore a un ITarget blocco da scollegare da questo choice blocco di messaggistica.

Scollega tutte le destinazioni da questo choice blocco di messaggistica.

virtual void unlink_targets();

Osservazioni:

Questo metodo non deve essere chiamato dal distruttore perché il distruttore per il blocco interno single_assignment verrà scollegato correttamente.

value

Ottiene il messaggio il choice cui indice è stato selezionato dal blocco di messaggistica.

template <
    typename _Payload_type
>
_Payload_type const& value();

Parametri

_Payload_type
Tipo del payload del messaggio.

Valore restituito

Payload del messaggio.

Osservazioni:

Poiché un blocco di messaggistica choice può accettare input con tipi diversi di payload, è necessario specificare il tipo del payload al momento del recupero. È possibile determinare il tipo in base al risultato del index metodo .

Vedi anche

Spazio dei nomi concurrency
Classe join
Classe single_assignment