Verse’te Race İfadeleri | Fortnite Dokümantasyon

race ifadesi, iki veya daha fazla asenk. ifadeden oluşan bir bloku eşzamanlı olarak (aynı anda) çalıştırmak için kullanılır. En hızlı ifade tamamlandığında “yarışı kazanır”. Kalan tüm “kaybeden” ifadeler iptal edilir, ardından race ifadesini takip eden ifadeler değerlendirilir.

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)

Aşağıdaki kod, race ifadesinin sözdizimini gösterir.

Verse

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

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

Aşağıdaki diyagramda ifadelerin yürütme akışı gösterilmektedir.

Race İfadesinin Kullanımı


Bir `race` ifadesi kullanabileceğin yerler	Asenk. bağlamlar
`race` ifadesinin çağrı zamanı	Asenk.
`race` kod bloku gereksinimleri	`race` ifadesinin gövdesinde en az iki ifade olmalı ve tüm ifadeler asenk. olmalıdır.
`race` ifadesi ne yapar?	`sync` ifadesine benzerdir ancak “kazanan” alt ifade dışında her şeyi iptal eder. Diğer ifadelerin herhangi biri önceki ifadeyle aynı simülasyon zamanında tamamlanırsa birinci (önceki) ifade “kazanır” ve beraberliği bozar. “Kaybeden” ifade görevleri iptal edilir.
`race` ifadesi ne zaman tamamlanır?	Kod blokundaki “kazanan” ifade tamamlandığında `race` tamamlanır. Bu, en hızlı, en kısa, ilk önce tamamlanan veya tamamlanması en az süren ifade anlamına gelir.
`race` ifadesinden sonraki ifade ne zaman başlar?	`race` ifadesini takip eden herhangi bir ifade, birinci ifade bittikten sonra başlar.
`race` ifadesinin sonucu	Bir `race` ifadesinin sonucu, tamamlanan ilk ifadenin sonucudur. Sonuç türü, kod blokundaki tüm ifadelerin en yaygın uyumlu türüdür.

Basit görünebilir ancak race, Verse cephaneliğindeki en kullanışlı ve güçlü ifadelerden biridir. Diğer isteğe göre karmaşık asenk. kodları, bir tür erken çıkış formu halinde yapılandırılmış bir şekilde durdurmada anahtar rolü oynar. Ne zaman durdurulacağını belirlemek için gereken sınamaları, durdurulacak koddan ayrı tutarak bunu çok temiz bir şekilde yapar.

Her asenk. ifade iptal edilebilir.
Sonsuz bir loop veya Sleep(Inf) gibi bazı asenk. ifadeler hiçbir zaman tamamlanmaz. Durdurulabilmeleri için tek yol, iptal edilmeleridir. Bu, bir veya daha fazla race ifadesiyle eşleştirildiğinde güçlü bir strateji olabilir.
Asenk. ifadeler iptal edilirse bir sonuç döndürmez, bu nedenle asenk. ifadeye dayalı olan değişkenler veya başka ifadeler bağlı durumda olmayacaktır.

Bazı karmaşık davranışları belirli bir süre sonra veya karmaşık bir olay sırası tetiklendikten sonra durdurmak mı gerekiyor? race olmadan, normalde karmaşık davranışın boyunca yoklama gibi sınamalar yerleştirmen gerekirdi. Oysa race ifadesiyle, tüm durdurma koşullarını karmaşık davranışa eş alt ifadeler olarak eklemen yeterlidir.

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

Bir race ifadesinin sonucu, hangi alt ifadenin ilk önce tamamlandığını, yani “yarışı” kazandığını belirlemek için kullanılabilir.

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