Wyrażenie race w Verse | Fortnite Dokumentacja

Wyrażenie wyścigu race służy do współbieżnego (jednoczesnego) wykonywania bloku dwóch lub większej liczby wyrażeń asynchronicznych. "Wyścig wygrywa" wyrażenie, które zakończy się najszybciej. Wszelkie pozostałe „przegrywające” wyrażenia są anulowane, a następnie każde wyrażenie, które następuje po race jest oceniane.

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)

Poniższy kod przedstawia składnię dla wyrażenia race.

Verse

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

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

Poniższy schemat przedstawia przepływ, zgodnie z którym wykonywane są wyrażenia.

Użycie wyrażenia race


Gdzie można użyć wyrażenia `race`	Konteksty asynchroniczne
Czas wywołania wyrażenia `race`	Async
Wymagania dotyczące bloku kodu `race`	Ciało wyrażenia `race` musi zawierać co najmniej dwa wyrażenia i wszystkie wyrażenia muszą być asynchroniczne.
Co wykonuje wyrażenie `race`	Działa podobnie jak wyrażenie `sync`, jednak anuluje wszystko poza "zwycięskim" podwyrażeniem. Jeśli jakiekolwiek inne wyrażenia zostaną ukończone w tym samym czasie symulacji, co wcześniejsze wyrażenie, pierwsze (wcześniejsze) wyrażenie "wygrywa" i przerywa każde powiązanie. Wszelkie zadania wyrażeń "przegrywających" zostają anulowane.
Czas ukończenia wyrażenia `race`	Wyrażenie `race` kończy się, gdy zakończy się "zwycięskie" wyrażenie w bloku kodu. Może to być najszybsze, najkrótsza długość, pierwsze ukończenie lub najkrótszy czas do ukończenia.
Kiedy rozpoczyna się kolejne wyrażenie po wyrażeniu `race`	Każde wyrażenie następujące po wyrażeniu `race` rozpoczyna się po zakończeniu pierwszego wyrażenia.
Wynik wyrażenia `race`	Wynikiem wyrażenia `race` jest wynik pierwszego ukończonego wyrażenia. Typ wyniku jest najczęściej typem zgodnym ze wszystkimi wyrażeniami w bloku kodu.

Choć może się wydawać proste, wyrażenie race to jedno z najbardziej użytecznych i potężnych wyrażeń w arsenale Verse. Jest to klucz do zatrzymania innego arbitralnie złożonego kodu asynchronicznego w uporządkowany sposób – forma wcześniejszego wyjścia. Robi to w bardzo czysty sposób, utrzymując wszelkie testy potrzebne do określenia momentu zatrzymania oddzielone od kodu, który ma zostać zatrzymany.

Każde wyrażenie asynchroniczne można anulować.
Niektóre wyrażenia asynchroniczne, takie jak niekończąca się pętla lub Sleep(Inf) nigdy nie zostaną ukończone. Jedynym sposobem na ich zatrzymanie jest ich anulowanie. Może to być silna strategia w połączeniu z jednym lub kilkoma wyrażeniami race.
Wyrażenia asynchroniczne nie będą miały wyniku, jeśli zostaną anulowane, więc każda zmienna lub inne wyrażenie, które zależy od anulowanego wyrażenia asynchronicznego, nie będzie związane.

Chcesz zatrzymać jakieś złożone zachowanie po pewnym czasie lub po wyzwoleniu złożonej sekwencji zdarzeń? Bez race normalnie konieczne byłoby stosowanie różnych testów, takich jak sondowanie w całym złożonym zachowaniu. W przypadku race wystarczy dodać wszystkie warunki zatrzymania jako równorzędne podwyrażenia do złożonego zachowania.

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

Wynik race może być użyty do określenia, które podwyrażenie ukończyło wyścig jako pierwsze lub wygrało.

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