Expression `race` dans Verse | Fortnite Documentation

L'expression race est utilisée pour exécuter simultanément un bloc de deux expressions asynchrones ou plus. Lorsque l'expression la plus rapide se termine, elle « gagne la course ». Les expressions « perdantes » restantes sont annulées, puis toute expression qui suit l'expression race est évaluée.

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)

Le code suivant montre la syntaxe de l'expression race.

Verse

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

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

Le diagramme ci-dessous montre le flux d'exécution des expressions.

Utiliser l'expression race


Possibilité d'utilisation d'une expression `race`	Contextes asynchrones
Temps d'invocation de l'expression `race`	Asynchrone
Exigences concernant le bloc de code de l'expression `race`	Le corps de l'expression `race` doit disposer d'au moins deux expressions, et toutes les expressions doivent être asynchrones.
À quoi sert l'expression `race`	Similaire à `sync,` mais annule tout sauf la sous-expression « gagnante ». Si d'autres expressions se terminent lors de la simulation de l'expression précédente, la première expression (précédente) « gagne » et rompt l'égalité. Toute tâche d'expression « perdante » est annulée.
Lorsque l'expression `race` se termine	L'expression `race` s'achève une fois terminée l'expression « gagnante » dans le bloc de code. Il peut s'agir de l'expression la plus rapide, de l'expression la plus courte, de celle qui s'est terminée en premier ou de celle qui a pris le moins de temps à s'achever.
Lorsque la prochaine expression après `race` démarre	Toute expression suivant l'expression `race` démarre une fois la première expression terminée.
Résultat de l'expression `race`	Le résultat d'une `race` est le résultat de la première expression qui s'est achevée. Le type de résultat est le type compatible le plus commun de toutes les expressions dans le bloc de code.

L'expression race peut paraître simple, mais elle est l'une des expressions les plus utiles et les plus puissantes de l'arsenal Verse. Il est essentiel d'arrêter tout autre code asynchrone arbitrairement complexe de manière structurée, comme s'il s'agissait d'une sortie anticipée. L'expression `race` effectue cette opération proprement, en séparant les tests dont l'arrêt doit être déterminé du code devant être discontinué.

Toute expression asynchrone peut être annulée.
Certaines expressions asynchrones, par exemple une expression loop sans fin ou Sleep(Inf), ne se terminent jamais. La seule façon de les arrêter est de les annuler. Cette stratégie est particulièrement efficace si elle est associée à une ou plusieurs expressions race.
Les expressions asynchrones n'ont pas de résultat si elles sont annulées ; ainsi, toute variable ou autre expression dépendant d'une expression asynchrone annulée n'est pas liée.

Vous avez besoin d'arrêter un comportement complexe après un certain temps ou après le déclenchement d'une séquence complexe d'événements ? Sans l'expression race, vous devriez normalement mettre en place des tests tout au long de votre comportement complexe, notamment des tests d'interrogation. Avec l'expression race, il suffit d'ajouter toutes les conditions d'arrêt comme sous-expressions sœurs au comportement complexe.

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

Vous pouvez utiliser le résultat de l'expression race pour déterminer quelle sous-expression s'est terminée en premier ou a gagné la course.

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