Race in Verse | Fortnite Dokumentation | Epic Developer Community

Der race expression wird verwendet, um einen block von zwei oder mehr async Ausdrücken gleichzeitig (simultan) auszuführen. Wenn der schnellste Ausdruck abgeschlossen ist, „gewinnt er das Rennen“. Alle verbleibenden „verlorenden“ Ausdrücke werden abgebrochen, dann wird jeder Ausdruck, der auf das race folgt, evaluated.

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)

Der folgende Code zeigt die syntax für den race-Ausdruck.

Verse

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

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

Das folgende Diagramm zeigt den execution-Ablauf der Ausdrücke.

Race-Ausdruck verwenden


Wo du einen `race`-Ausdruck verwenden kannst	Async contexts
Aufrufzeit des `race`-Ausdrucks	Async
Anforderungen für den `race` Codeblock	Der Körper des `race`-Ausdrucks muss mindestens zwei Ausdrücke haben, und alle Ausdrücke müssen asynchron sein.
Was der `race`-Ausdruck bewirkt	Ähnlich wie `sync`, bricjt aber alle bis auf den „gewinnenden“ Unterausdruck ab. Wenn andere Ausdrücke zur gleichen Simulationszeit wie der frühere Ausdruck abgeschlossen werden, „gewinnt“ der erste (frühere) Ausdruck und hebt jeden Gleichstand auf. Alle „verlorenen“ Ausdrucksaufgaben werden abgebrochen.
Wenn der `race` Ausdruck abgeschlossen ist	Das `race` ist abgeschlossen, wenn der „gewinnende“ Ausdruck im Codeblock abgeschlossen ist. Dies bezieht sich auf die schnellste, kürzeste Länge, den ersten Abschluss oder die geringste Zeitspanne, die für den Abschluss benötigt wird.
Wenn der nächste Ausdruck nach dem `race` beginnt	Jeder Ausdruck, der auf den `race`-Ausdruck folgt, wird gestartet, sobald der erste Ausdruck abgeschlossen ist.
Ergebnis des `race`-Ausdrucks	Das Ergebnis eines `race` ist das Ergebnis des ersten abgeschlossenen Ausdrucks. Das Ergebnis type ist der am häufigsten gängige kompatible Typ aller Ausdrücke im Codeblock.

Das mag einfach erscheinen, aber race ist einer der nützlichsten und mächtigsten Ausdrücke im Verse-Arsenal. Es ist der Schlüssel, um die anderen beliebig komplexen asynchronen Codes auf strukturierte Weise anzuhalten – eine Form des vorzeitigen Ausstiegs. Dies geschieht auf eine sehr saubere Art und Weise, indem jeder Test, der notwendig ist, um zu bestimmen, wann gestoppt werden soll, von dem zu stoppenden Code getrennt abläuft.

Jeder asynchrone Ausdruck kann abgebrochen werden.
Einige asynchrone Ausdrücke, wie z. B. eine Endlosschleife loop oder Sleep(Inf) werden nie abgeschlossen. Der einzige Weg, um sie zu stoppen, besteht darin, cancel auszuführen. Wenn es mit einem oder mehreren race -Ausdrücken gepaart wird, kann dies eine starke Strategie sein.
Asynchrone Ausdrücke werden kein result haben, wenn sie abgebrochen werden, sodass jede Variable oder jeder andere Ausdruck, der von einem abgebrochenen asynchronen Ausdruck abhängt, nicht bound sein würde.

Musst du ein komplexes Verhalten nach einer bestimmten Zeit oder nachdem eine komplexe Abfolge von Eventen ausgelöst wurde anhalten? Ohne race müsstest du normalerweise Tests wie zum Beispiel polling über dein gesamtes komplexes Verhalten verteilen. Mit race musst du nur alle Stopp-Bedingungen dem komplexen Verhalten als gleichberechtigte Unterausdrücke hinzufügen.

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

Ein race-Ergebnis kann verwendet werden, um festzustellen, welche subexpression zuerst fertig war, oder das Rennen gewonnen hat.

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