Race в Verse | Fortnite Документация

Выражение race («гонка») используется для конкурентного (одновременного) выполнения блока из двух или более асинхронных выражений. Выражение, которое выполнится быстрее, «выиграет гонку». Любые оставшиеся «проигравшие» выражения отменяются, а затем оценивается любое выражение, следующее за race.

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)

В следующем коде показан синтаксис выражения race.

Verse

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

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

На блок-схеме ниже представлен ход выполнения потока выражений.

Использование выражения race


Когда можно использовать выражение `race`	Асинхронные контексты
Время обращения к выражению `race`	Асинхронность
Требования к блоку кода `race`	Тело выражения `race` должно содержать как минимум два выражения, каждое из которых должно быть асинхронным.
Что делает выражение `race`	Аналогично `sync`, однако отменяет всё, кроме «победившего» подвыражения. Если какие-либо другие выражения завершаются в то же время симуляции, что и более раннее выражение, первое (более раннее) выражение «побеждает». Задачи всех «проигравших» выражений отменяются.
Когда завершается выражение `race`	Выражение `race` завершается, когда завершено первое выражение в блоке кода. Это может быть самое быстрое, самое короткое, самое первое или наименьшее по времени выполнения выражение.
Когда запускается следующее выражение после `race`	Любое выражение, следующее за выражением `race`, запускается после завершения первого выражения.
Результат выражения `race`	Результатом выражения `race` является результат первого завершённого выражения. Тип результата будет относиться к наиболее общему совместимому типу всех выражений в блоке кода.

Это выражение может показаться простым, но race — одно из самых полезных и мощных выражений в арсенале Verse. Оно позволяет остановить другой произвольный сложный асинхронный код структурированным способом — досрочным выходом из блока. Оно делает это очень простым способом, отделяя все тесты, необходимые для определения момента остановки, от кода, который должен быть остановлен.

Любое асинхронное выражение можно отменить.
Некоторые асинхронные выражения, такие как бесконечный цикл loop или Sleep(Inf), никогда не завершаются. Единственный способ их остановить — это отменить их. Их можно очень эффективно применять в сочетании с одним или несколькими выражениями race.
Асинхронные выражения не будут иметь результата в случае отмены, поэтому любая переменная или другое выражение, зависящее от отменённого асинхронного выражения, не будет привязано.

Хотите остановить какое-то сложное поведение по истечении некоторого времени или после запуска какой-то сложной последовательности событий? Если бы не выражение race, вам бы пришлось использовать тесты, к примеру опрос, на протяжении всего сложного поведения. При использовании race к сложному поведению нужно лишь добавить все условия остановки в качестве подвыражений одного уровня.

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

Результат race можно использовать, чтобы определить, какое подвыражение завершилось первым или «выиграло гонку».

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