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 .

link_target

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.

unlink_target

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.

unlink_targets

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