Race en Verse | Fortnite Documentación | Epic Developer Community

La expresión race se utiliza para ejecutar un bloque de dos o más expresiones asíncronas de forma concurrente (simultánea). La expresión que se completa antes «gana la carrera». Cualquier expresión «perdedora» restante se cancela y, a continuación, cualquier expresión que siga a race se evalúa.

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)

El siguiente código muestra la sintaxis (de la expresión race.

Verse

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

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

El diagrama siguiente muestra el flujo de ejecución de las expresiones.

Uso de la expresión `race`


Dónde se puede usar una expresión `race`	Contextos asíncronos
Hora de invocación de la expresión `race`	Asinc.
Requisitos del bloque de código de `race`	El cuerpo de la expresión `race` debe tener al menos dos expresiones, y todas ellas deben ser asíncronas.
Qué hace la expresión `race`	Similar a `sync` aunque cancela todo excepto la subexpresión «ganadora». Si cualquier otra expresión se completa en el mismo tiempo de simulación que la expresión anterior, la primera expresión (anterior) «gana» y rompe cualquier empate. Cualquier tarea de expresión «que se pierda» se cancela.
Cuando finaliza la expresión `race`	`race` se completa cuando la expresión «ganadora» del bloque de código se ha completado. Hace referencia a la más rápida/de menor longitud/primera completada/de menor tiempo para completar.
Cuando se inicia la siguiente expresión después de `race`	Cualquier expresión que siga a la expresión `race` se inicia una vez que termina la primera expresión.
Resultado de la expresión `race`	El resultado de una expresión `race` es el resultado de la primera expresión completada. El tipo de resultado es el tipo compatible más común de todas las expresiones del bloque de código.

Puede parecer simple, pero race es una de las expresiones más útiles y potentes del arsenal de Verse. Es clave para detener otro código asíncrono arbitrariamente complejo de forma estructurada, una forma de salida anticipada. Lo hace de una manera muy limpia, manteniendo las pruebas necesarias para determinar cuándo parar separadas del código que se va a detener.

Cualquier expresión asíncrona puede ser cancelada.
Algunas expresiones asíncronas como un loop o Sleep(Inf) interminables nunca se completarán. Y la única forma de detenerlas es cancelarlas. Esta puede ser una buena estrategia, especialmente si se combina con una o más expresiones de race.
Las expresiones asíncronas no tendrán un resultado si se cancelan, por lo que cualquier variable u otra expresión que dependa de una expresión asíncrona cancelada no estaría vinculada.

¿Necesitas detener un comportamiento complejo después de cierto tiempo o después de que se desencadene una secuencia compleja de eventos? Sin race, normalmente tendrías que esparcir pruebas, como el sondeo por todo tu comportamiento complejo. Con race solo tienes que añadir todas las condiciones de parada como subexpresiones hermanas al comportamiento complejo.

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

El resultado de race puede utilizarse para determinar qué subexpresión terminó primero o ganó la carrera.

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