Race in Verse | Fortnite Documentazione | Epic Developer Community

L' espressione race viene utilizzata per eseguire un blocco di due o più espressioni asincrone contemporaneamente. Quando l'espressione più veloce termina, "la gara viene vinta". Eventuali espressioni "perdenti" rimanenti vengono annullate, quindi viene valutata qualsiasi espressione che segue race .

Verse

set WinnerResult = race:
    # All three async functions start at the same time
    AsyncFunctionLongTime()
    AsyncFunctionShortTime()  # This will win and its result is used
    AsyncFunctionMediumTime()
# Next expression is called after the fastest async function completes
# / when the fastest/shortest async function task (AsyncFunctionShortTime()) completes
# and all other async function tasks (AsyncFunctionLongTime(), AsyncFunctionMediumTime()) are canceled.
NextExpression(WinnerResult)

set WinnerResult = race:
    # All three async functions start at the same time
    AsyncFunctionLongTime()
    AsyncFunctionShortTime()  # This will win and its result is used
    AsyncFunctionMediumTime()
# Next expression is called after the fastest async function completes
# / when the fastest/shortest async function task (AsyncFunctionShortTime()) completes
# and all other async function tasks (AsyncFunctionLongTime(), AsyncFunctionMediumTime()) are canceled.
NextExpression(WinnerResult)

Il codice seguente mostra la sintassi dell'espressione race.

Verse

expression0
race:
    slow-expression
    mid-expression
    fast-expression
expression1

expression0
race:
    slow-expression
    mid-expression
    fast-expression
expression1

Il diagramma seguente mostra il flusso di esecuzione delle espressioni.

Utilizzo dell'espressione race


Dove è possibile utilizzare un'espressione `race`	Contesti asincroni
Tempo di invocazione dell'espressione `race`	Asincrono
Requisiti per il blocco di codice `race`	Il corpo dell'espressione `race` deve contenere almeno due espressioni e tutte le espressioni devono essere async.
Che cosa fa l'espressione `race`	Simile a `sync`, ma annulla tutto tranne la sottoespressione"vincente". Se altre espressioni si completano nello stesso tempo di simulazione dell'espressione precedente, la prima espressione (precedente) "vince" e rompe qualsiasi parità. Eventuali task di espressione "perdenti" vengono annullati.
Al termine dell'espressione `race`	La `race` è completata quando l'espressione "vincente" nel blocco di codice è stata completata. Questo si riferisce al più veloce, alla lunghezza più breve, al primo completamento o alla minor quantità di tempo per il completamento.
Quando inizia l'espressione successiva a `race`	Qualsiasi espressione che segue l'espressione `race` viene avviata al termine della prima espressione.
Risultato dell'espressione `race`	Il risultato di una `race` è il risultato della prima espressione completata. Il tipo di risultato è il tipo compatibile più comune di tutte le espressioni del blocco di codice.

Può sembrare una cosa semplice, ma race è una delle espressioni più utili e potenti dell'arsenale di Verse. È un keyframe fondamentale per arrestare altro codice asincrono arbitrariamente complesso in modo strutturato, una forma di uscita anticipata. Lo fa in modo molto pulito, mantenendo tutti i test necessari per determinare quando arrestarli separati dal codice che deve essere interrotto.

Qualsiasi espressione asincrona può essere annullata.
Alcune espressioni asincrone, come ad esempio un loop infinito o Sleep(Inf), non verranno mai completate. L'unico modo in cui possono essere arrestate è annullarle. Questa può essere una strategia efficace se associata a una o più espressioni race.
Le espressioni asincrone non avranno un risultato se sono annullate, quindi qualsiasi variabile o altra espressione che dipende da un'espressione asincrona non sarebbe limite.

Hai bisogno di interrompere un comportamento complesso dopo un certo periodo di tempo o dopo una sequenza complessa di attivatore eventi? Senza race, normalmente dovresti eseguire test a pioggia, come ad esempio il polling di tutti, durante il tuo comportamento complesso. Con race, devi solo aggiungere tutte le condizioni di stop come sottoespressioni fratello al comportamento complesso.

Verse

race:
    ComplexBehavior() # Could be simple or as complex as a whole game
    Sleep(60.0)       # Timeout after one minute
    EventTrigger()    # Some other arbitrary test that can be used to stop

race:
    ComplexBehavior() # Could be simple or as complex as a whole game
    Sleep(60.0)       # Timeout after one minute
    EventTrigger()    # Some other arbitrary test that can be used to stop

Un risultato race può essere utilizzato per determinare quale sottoespressione è arrivata per prima o ha vinto la race.

Verse

# Adding a unique result to subexpressions so it can
# be used to determine which subexpression won
Winner := race:
    block:        # task 1
        AsyncFunction1()
        1
    block:        # task 2
        AsyncFunction2a()
        AsyncFunction2b()
        AsyncFunction2c()