Race em Verse | Fortnite Documentação | Epic Developer Community

A expressão race é usada para executar um bloco de duas ou mais expressões assíncronas ao mesmo tempo (simultaneamente). Quando a expressão mais rápida é concluída, ela "ganha a corrida". Como as expressões "perdedoras" restantes são canceladas, qualquer expressão depois de race será avaliada.

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)

O código a seguir mostra a sintaxe da expressão race.

Verse

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

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

O diagrama abaixo mostra o fluxo de execução das expressões.

Uso da expressão "race"


Onde uma expressão `race` pode ser usada	Contextos assíncronos
Tempo de invocação da expressão `race`	Assíncrona
Requisitos do bloco de código de `race`	O corpo da expressão `race` deve ter pelo menos duas expressões, e todas as expressões devem ser assíncronas.
O que faz a expressão `race`	Semelhante a `sync`, mas cancela tudo, exceto a subexpressão vencedora. Se outras expressões forem concluídas no mesmo tempo de simulação que a expressão anterior, a primeira expressão (anterior) "vencerá" e desempatará. Qualquer tarefa de expressão "perdedora" será cancelada.
Quando a expressão `race` é concluída	A expressão `race` é concluída quando a expressão "vencedora" no bloco de código é concluída. Isso se refere à mais rápida, a de menor comprimento, a de primeira conclusão ou a de menor quantidade de tempo para concluir.
Quando inicia a expressão que vem depois que `race` inicia	Qualquer expressão que vem depois de `race` será iniciada assim que a primeira expressão terminar.
O resultado da expressão `race`	O resultado de uma expressão `race` é o resultado da primeira expressão concluída. O tipo de resultado é o tipo compatível mais comum de todas as expressões no bloco de código.

Isso pode parecer simples, mas race é uma das expressões mais úteis e poderosas no arsenal de Verse. Ela é a chave para interromper qualquer outro código assíncrono complexo arbitrariamente de maneira estruturada. É uma forma de saída antecipada. Ele faz isso de uma maneira muito limpa, mantendo todos os testes necessários para determinar quando parar separados do código que deve ser interrompido.

Expressões assíncronas podem ser canceladas.
Algumas expressões assíncronas, como um loop ou Sleep(Inf) sem fim, nunca serão concluídas. A única maneira de interrompê-las é cancelá-las. Essa pode ser uma estratégia sólida quando combinada com uma ou mais expressões race.
Expressões assíncronas não terão um resultado se forem canceladas. Portanto, qualquer variável ou outra expressão que dependa de uma expressão assíncrona cancelada não seria vinculada.

Precisa interromper algum comportamento complexo após o disparo de uma quantidade de tempo ou sequência complexa de eventos? Sem race, normalmente você precisaria espalhar testes, como difundi-los em todo o seu comportamento complexo. Com race, basta adicionar todas as condições de parada como subexpressões irmãs ao comportamento complexo.

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

Um resultado de race pode ser usado para determinar qual subexpressão terminou primeiro ou venceu a corrida.

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()