1. Epic GamesDeveloper
  3. Verse Dili Hızlı Referansı

Verse Dili Hızlı Referansı

Bir Verse özelliği hakkında bilgilerini tazelemek mi istiyorsun? Bu hızlı referans sana yardımcı olabilir!

Verse Dili Hızlı Referansı

Verse programlama dilinin tüm özellikleri ve sözdizimi hakkında bir hızlı referans kaynağı olarak bu dokümanı kullan. Daha fazla bilgi edinmek için bağlantıları izle.

İfadeler

İfade, hesaplandığında bir değer oluşturan en küçük kod birimidir. Bir örneği if ... else ifadesidir. Verse’te ifade bloklarının içeriğine bağlı bir değer olarak hesaplanır.

Aşağıdaki kod, MyNumber değerinin 5’ten büyük olup olmamasına bağlı olarak “Big!” veya “Small!” değerini içeren bir dizeyi değerlendirir:

Verse 
if (MyNumber > 5):
    "Big!"
else:
    "Small!"

Kod Açıklamaları

Kod açıklaması, kodla ilgili bir şeyi veya programcının bir şeyin programlanış biçiminin sebebini açıklamasını sağlar. Program çalıştığında kod açıklamaları dikkate alınmaz.

Verse 
1+2 # Hello

Tek satırlı açıklama: # ile satır sonu arasında görünen her şey kod açıklamasına dahildir.

Verse 
1<# inline comment #>+2

Satır içi blok açıklama: <# ile #> arasında görünen her şey kod açıklamasına dahildir. Satır içi blok açıklamalar, tek bir satırdaki ifadeler arasında olabilir ve ifadeleri değiştirmez.

Verse 
DoThis()
<# And they
can run multiple
long lines #>
DoThat()

Çok satırlı blok açıklama: <# ile #> arasında görünen her şey kod açıklamasına dahildir. Çok satırlı blok açıklamalar birden çok satıra yayılabilir.

Verse 
<# Block comments nest <# like this #> #>

İç içe yerleştirilmiş blok açıklama: <# ile #> arasında görünen her şey kod açıklamasına dahildir ve iç içe yerleştirilebilir. Bu özellik, mevcut bir kod açıklamasını değiştirmeden test etme ve hata ayıklama için bir satırdaki bazı ifadeleri açıklamak istiyorsan faydalı olabilir.

Verse 
<#>
    Here is a long
    description spanning
    multiple lines.
DoThis() # This expression is not part of the indented comment

Girintili açıklama: <#> ifadesinden sonra yeni satırlarda görünen ve dört boşluk girintili olan her şey kod açıklamasına dahildir. Dört boşluk girintili olmayan ilk satır, kod açıklamasının bir parçası değildir ve kod açıklamasını sonlandırır.

Sabitler ve Değişkenler

Sabitler ve değişkenler, programının kullandığı bilgileri ya da değerleri depolayabilir ve bu değerleri bir adla ilişkilendirebilir. Ad tanımlayıcıdır.

Kendi değişkenini veya sabitini oluşturmak için Verse’e bunu söylemen gerekir. Buna bildirim denir. Başlatma adı verilen bir başlangıç değeri belirtmek, değişkenler için isteğe bağlı (ancak önerilen), sabitler içinse zorunlu bir eylemdir.

Bir değişkenin değerini istediğin zaman değiştirebilirsin. Değişkene bir değer atadığın için bu kavram atama olarak adlandırılır ancak bazı durumlarda değişkeni ayarlama olarak da anılır.

Verse 
name : type = value

Sabit oluşturma: Bir sabitin değeri program çalışırken değiştirilemez. Adını, türünü ve değerini belirterek bir sabit oluşturabilirsin.

Verse’te sabit oluşturma

Büyütmek için görsele tıkla.

Verse 
var name : type = value

Değişken oluşturma: Bir değişkenin değeri program çalışırken değiştirilebilir. Bir değişkeni, adının önüne var anahtar sözcüğünü ekleyerek oluşturabilirsin. Bunun adını, türünü ve (isteğe bağlı olarak) başlangıç değerini belirtmen gerekir.

Verse’te değişken oluşturma

Büyütmek için görsele tıkla.

Verse 
set name = value

Değişkenin değerini değiştirme: Program çalışırken set = anahtar sözcüğünü kullanarak bir değişkenin değerini değiştirebilirsin.

Verse’te değişken ayarlama

Büyütmek için görsele tıkla.

Türler

Verse statik türde bir programlama dilidir, yani her tanımlayıcıya bir tür atanır.

Bir fonksiyonda sabit oluştururken olduğu gibi türün açıkça gerekli olmadığı örnekler vardır. MyConstant := 0 örneğinde MyConstant için atanan değer 0 olduğundan türü çıkarsanır.

Yaygın Türler

Verse çoğu programın çalışmak için ihtiyaç duyduğu temel işlemleri destekleyen yerleşik türlere sahiptir. Bunları daha büyük yapılar halinde birleştirerek kendi türlerini oluşturabilirsin ancak Verse’te değişken ve sabitleri kullanmanın temeli olarak yaygın türleri anlamak önemlidir.

Verse 
TargetLocked : logic = false

logic: Verse’te logic, Boole değerlerinin türüdür. Diğer bir deyişle logic yalnızca iki olası değerde olabilir: true ve false. logic türü hakkında daha fazla bilgi almak için Logic kısmına bakabilirsin.

Verse 
AnswerToTheQuestion : int = 42

int: Verse’te int pozitif bir sayı, negatif bir sayı veya sıfır içerebilir ve kesirli bileşeni yoktur. Tamsayı değerleri aşağıdaki değerler arasında olabilir:

  • Min.: -9.223.372.036.854.775.808

  • Maks.: 9.223.372.036.854.775.807 int türü hakkında daha fazla bilgi edinmek için Int kısmına bakabilirsin.

Verse 
MyScore : float = 100.0

float: Verse’te float bir ondalık basamağı olan pozitif veya negatif bir sayı, sıfır ya da NaN (Sayı Değil) değeri içerebilir. Kayan nokta değerleri aşağıdaki değerler arasında olabilir:

  • Min.: -2^1023 * (1 + (1 - 2^(-52)))

  • Maks.: -2^1023 * (1 + (1 - 2^(-52))) float türü hakkında daha fazla bilgi almak için Float kısmına bakabilirsin.

Verse 
# The winning player's name:
WinningPlayerName : string = "Player One"

# Build a message announcing the winner.
Announcement : string = "...And the winner is: {WinningPlayerName}!"

string: Verse’te string; harfler, sayılar, noktalama işaretleri, boşluklar ve emojiler 🐈 içerebilir. Hiçbir karakter içmeyen "" bir dize (string), boş dize olarak adlandırılır.

Bir ifadenin sonucunu, "" içinde {} kullanarak bir dizeye ekleyebilirsin. Buna dize interpolasyonu adı verilir.

string türü hakkında daha fazla bilgi almak için String kısmına bakabilirsin.

Verse 
# The winning player's name:
PlayerName<localizes> : message = "Player One"

# Build a message announcing the winner.
Announcement<localizes>(WinningPlayerName : string) : message = "...And the winner is: {WinningPlayerName}"

Billboard.SetText(Announcement("Player One"))

message: Verse’te message, yerel ayardan bağımsız metinler içerebilir. Bir message değişkenini bir string değeriyle başlatırsan bu dize, mesaj için varsayılan metin ve dil olur. Localizes belirleyicisi, yerelleştirilebilir metin üretmek için yeni bir mesaj tanımlanırken gereklidir.

Localize() fonksiyonunu kullanarak metni çalışma zamanında gösterilebilir bir dizeye dönüştürebilirsin. Bunu yapmak metni senin geçerli yerel ayarına göre biçimlendirir.

Şu anda Localize() fonksiyonu tarafından döndürülebilen tek metin, mesajını oluştururken sağladığın varsayılan metindir.

Verse 
Localize(Announcement("Player One"))

locale: Bu tür, bir message değerinin hangi bağlamda yerelleştirilmesi gerektiğini gösterir. Bu tür, yerel ayarda ortak olan metnin dilini ve sayıların nasıl gösterileceğini etkiler.

Şu anda locale türü tamamen uygulanmaz, bu nedenle Localize() fonksiyonu yalnızca mesajı oluştururken sağladığın varsayılan metni döndürecektir.

Verse 
if (MaxQuiversYouCanBuy : int = Floor(Coins / CoinsPerQuiver)):
    MaxArrowsYouCanBuy : int = MaxQuiversYouCanBuy * ArrowsPerQuiver

rational: rational türü, tamsayı bölümünün sonucudur ve yalnızca aşağıdaki fonksiyonların bağımsız değişkeni olarak kullanılabilir:

  • Floor(): Rasyonel sayıyı altındaki en yakın tamsayıya yuvarlar.

  • Ceil(): Rasyonel sayıyı üstündeki en yakın tamsayıya yuvarlar. rational türü hakkında daha fazla bilgi almak için Rational kısmına bakabilirsin.

Verse 
var MyScore : int = 100

IncreaseScore() : void =
    Points : int = 10

    set MyScore = MyScore + Points

    Print("After you scored, MyScore is {MyScore}.")

void: void türü aşağıdaki senaryolarda kullanışlıdır:

  • Bir fonksiyonun sonucunun faydalı olmadığını belirten dönüş türü olarak.

  • Değerin faydalı olmadığını belirten sabit veya fonksiyon parametrelerinin türü olarak. Örneğin, bir fonksiyon tanımını geçersiz kılarken sabitler veya fonksiyon parametreleri için void kullan.

void türü hakkında daha fazla bilgi almak için Void kısmına bakabilirsin.

Verse 
FunctionTakingAnything(Argument : any):void = {}

Main() : void =
    FunctionTakingAnything(1)
    FunctionTakingAnything("2")
    FunctionTakingAnything(array{3.0})
    FunctionTakingAnything(FunctionTakingAnything)

any: any türü tüm türlerin üst türüdür. any türü hakkında daha fazla bilgi almak için Any kısmına bakabilirsin.

Verse 
Filter(Array : []t, Element : comparable where t : subtype(comparable)) : []t =
    for (OtherElement : Array; OtherElement = Element):
        OtherElement

comparable: comparable türü, bu türdeki herhangi bir değerin bu türden herhangi bir başka değerle eşit olup olmadığının karşılaştırılabilmesini gerektirir. comparable türü, eşitlik açısından karşılaştırılabilen tüm türlerin üst türüdür. comparable türü hakkında daha fazla bilgi almak için Comparable kısmına bakabilirsin.

Verse’teki yaygın türler hakkında daha fazla bilgi almak için Yaygın Türler kısmına bakabilirsin.

Kapsayıcı Türleri

Bir kapsayıcı türü kullanarak birden fazla değeri bir arada saklayabilirsin. Verse, içinde değerlerin depolanabileceği birkaç kapsayıcı türüne sahiptir. Verse’teki kapsayıcı türleri hakkında daha fazla bilgi almak için Kapsayıcı Türleri kısmına bakabilirsin.

Seçenek

option türü bir değer içerebilir veya boş olabilir.

Aşağıdaki örnekte MaybeANumber hiçbir değer içermeyen isteğe bağlı bir ?int tamsayısıdır. Bu durumda MaybeANumber için yeni değer 42 olarak ayarlanır.

Verse 
var MaybeANumber : ?int = false # unset optional value
set MaybeANumber := option{42} # assigned the value 42
Verse’te seçenek değişkeni oluşturma

Büyütmek için görsele tıkla.

Verse 
MaybeANumber : ?int = option{42} # initialized as 42

MaybeAnotherNumber : ?int = false # unset optional value

Seçenek oluşturma: Bir seçeneği aşağıdakilerden biriyle başlatabilirsin:

  • Değer yok: Seçeneği ayarlanmamış olarak işaretlemek için false değerini ata.

  • Başlangıç değeri: option anahtar sözcüğünü ve ardından {} karakterlerini kullan. {} arasına bir ifade yerleştir. İfade başarısız olursa seçenek ayarlanmamış olur ve false değerini alır.

Seçenekte depolanması beklenen değer türünün önüne ? ekleyerek türü belirt. Örneğin ?int.

Verse 
if (Number := MaybeANumber?):
    Number # if MaybeANumber is not empty, then its value is stored in Number for you to use.

Seçenek içindeki bir elemana erişim: Seçenekle birlikte ? sorgu işlecini kullan, MaybeANumber? gibi. Seçenekte bir değer olmayabileceğinden bir seçenekte depolanmış değere erişmek, başarısız olabilir ifadedir ve bu nedenle bir başarısızlık bağlamında kullanılmalıdır.

Aşağıda, doğan bir oyuncuya yönelik referansı kaydetmek ve oyuncu doğduğunda tetikleyici cihazın tepki vermesini sağlamak için bir seçenek (option) türünün kullanıldığı bir örnek yer alıyor:

Verse 
my_device := class<concrete>(creative_device):
    var SavedPlayer : ?player = false # unset optional value

    @editable
    PlayerSpawn : player_spawner_device = player_spawner_device{}

    @editable
    Trigger : trigger_device = trigger_device{}

    OnBegin<override>() : void =

Aralık

range ifadesi, belirtilen bir aralıktaki tüm sayıları içerir ve yalnızca for ifadesi gibi belirli ifadelerde kullanılabilir. Aralık değerleri yalnızca tamsayı olabilir.

Verse’te aralık oluşturma

Büyütmek için görsele tıkla.

Verse 
0..5

Aralık oluşturma: Aralığın başlangıcı, ifadedeki ilk değer; aralığın sonu ise ifadede .. işaretinden sonraki değerdir. Aralık, başlangıç ve bitiş değerlerinin kendileri de dahil olmak üzere bunlar arasındaki tüm tamsayıları içerir.

Verse 
for (Number := 0..5):
   Number

Bir aralıkta yineleme: for ifadesini kullanarak bir sayı sekansını yineleyebilirsin. Daha fazla bilgi için for kısmına bakabilirsin.

Daha fazla bilgi için Aralık kısmına bakabilirsin.

Dizi

Dizi, aynı türden elemanları depolayabileceğin bir kapsayıcıdır. Dizide elemanlara konumlarına göre erişebilirsin. Bu konuma dizin adı verilir. Bir dizideki ilk dizin 0, son dizin dizideki öğe sayısının bir eksiğidir.

Verse 
Players : []player = array{Player1, Player2}
Verse’te dizi oluşturma

Büyütmek için görsele tıkla.

Verse 
ExampleArray : []int = array{10, 20, 30, 40, 50}

Dizi oluşturma: array anahtar sözcüğünü ve ardından {} karakterlerini kullan. Dizide başlangıç elemanlarını belirlemek istiyorsan ifadeleri {} karakterleri arasına birbirlerinden , ile ayrılacak şekilde ekle. Dizide depolanması beklenen değer türünün önüne [] ekleyerek türü belirt. Örneğin, []int şeklinde.

Verse 
if (Element := ExampleArray[0]):
    Element

Dizideki bir elemana erişme: Erişmek istediğin elemanın diziniyle birlikte [] kullan, örneğin ExampleArray[0]. Dizinde bir eleman olmayabileceğinden ilgili dizide depolanmış değere erişmek başarısız olabilir ifadedir ve bu nedenle bir başarısızlık bağlamında kullanılmalıdır.

Verse 
var ExampleArray : []int = array{20, 21, 22}
if (set ExampleArray[1] = 77) {}

Dizideki bir elemanı değiştirme: Bir dizindeki dizi değişkeninde depolanmış değeri set = anahtar sözcüğünü kullanarak değiştirebilirsin.

Verse 
for (Item : ExampleArray):
   Item

for (Index -> Item : ExampleArray):
    Print("{Item} in ExampleArray at index {Index}")

Bir dizide yineleme: Bir dizideki her elemana birinciden sonuncuya giden sırayla for ifadesi kullanarak erişebilirsin. for ifadesiyle, (Item : ExampleArray) sözdizimini kullanarak elamanı veya (Index -> Item : ExampleArray) sözdizimini kullanarak elemanı ve dizinini alabilirsin.

Verse 
ExampleArray.Length

Dizideki eleman sayısını alma: Dizide .Length kullandığında sonucu dizideki eleman sayısı olacaktır.

Verse 
# Array1 is an array of integers
Array1 : []int = array{10, 11, 12}

# Array2 is an array variable of integers
var Array2 : []int = array{20, 21, 22}

# After Array2 is updated in the next line, its elements are [10, 11, 12, 20, 21, 22, 5, 31]
set Array2 = Array1 + Array2 + array{5, 31}

Dizileri birleştirme: + işlecini kullanarak dizileri birleştirebilirsin.

Daha fazla bilgi için Dizi kısmına bak.

demet

Demet, tek bir ifade olarak ele alınan iki veya daha fazla ifadenin gruplandırılmış halidir. İfadedeki öğelerin sırası önemlidir. Aynı ifade, bir demetin birden fazla konumunda olabilir. Demet ifadeleri herhangi bir türde olabilir ve (yalnızca bir türden eleman içerebilen dizilerin aksine) karışık türlere sahip olabilir.

Demetler özellikle aşağıdaki durumlarda faydalıdır:

  • Bir fonksiyondan birden fazla değer döndürürken.

  • Bir fonksiyona birden fazla değer geçirirken.

  • Yerinde gruplandırma, yeniden kullanılabilir bir veri yapısı (bir struct veya class gibi) oluşturma ek yüküne göre daha kestirme bir yoldur.

    Verse 
          ExampleTuple : tuple(int, float, string) = (1, 2.0, "three")
Verse’te demet oluşturma

Büyütmek için görsele tıkla.

Verse 
ExampleTuple : tuple(int, float, string) = (1, 2.0, "three")

Demet oluşturma: () kullan ve birbirinden , ile ayrılmış iki veya daha fazla eleman belirt. tuple anahtar sözcüğünü ve ardından () işaretini kullanarak türü belirt. Her bir elemanın türü () arasında açıkça belirtilmelidir. Örneğin tuple(int, float, string).

Demetteki bir elemana erişme: Erişmek istediğin elemanın diziniyle birlikte () kullan. Örneğin ExampleTuple(0) şeklinde. Bir demette depolanan değere erişmek başarısız olabilir bir ifade değildir.

Demet genişlemesi: Her bağımsız değişkeni belirtmek yerine bir demeti bir fonksiyonun bağımsız değişkeni olarak kullandığında; fonksiyon, bağımsız değişken olarak kullanılan demetteki her bir eleman ile birlikte öğelerin demette belirtildikleri sırayla çağrılır.

Demet dizisini zorlama: Demetler, demet elemanlarının türleri dizi ile aynı türde olmak şartıyla bir dizinin beklendiği her durumda geçirilebilir. Bir demetin beklendiği durumlarda diziler geçirilemez.

Daha fazla bilgi için Demet kısmına bakabilirsin.

Harita

Harita, anahtar-değer çifti adı verilen başka bir değerle ilişkili değerleri depolayabileceğin ve öğelere benzersiz anahtarlarına göre erişebileceğin bir kapsayıcıdır.

Verse 
WordCount : [string]int = map {"apple" => 11, "pear" => 7}
Verse’te harita oluşturma

Büyütmek için görsele tıkla.

Harita oluşturma: map anahtar sözcüğünü ve ardından {} karakterlerini kullan. Haritadaki başlangıç elemanlarını belirlemek istiyorsan anahtar-değer çiftlerini, {} işaretleri arasına birbirlerinden , ile ayrılacak şekilde ekle. [key-type] ekleyerek türü belirt. Burada key-type, haritada depolanması beklenen değer türünün önündeki anahtarlar için kullanılan türdür. Örneğin [string]int.

Haritadaki bir elemana erişme: Erişmek istediğin elemanın anahtarıyla birlikte [] kullan. Örneğin ExampleMap[Key] şeklinde.

Harita üzerinde yineleme: Bir haritadaki her elemana birinciden sonuncuya giden sırayla for ifadesi kullanarak erişebilirsin. for ifadesiyle, (Value : ExampleMap) sözdizimini kullanarak elemanı veya (Key -> Value: ExampleMap) sözdizimini kullanarak elemanı ve anahtarını alabilirsin.

Haritadaki anahtar-değer çiftlerinin sayısını alma: Haritada .Length kullandığında sonucu haritadaki eleman sayısı olacaktır.

Daha fazla bilgi için Harita kısmına bakabilirsin.

Kompozit Türler

Kompozit tür, primitif veya diğer türlerin alan ve elemanlarından (genellikle adlandırılmış) oluşabilen herhangi bir türdür. Bileşik türler ömrü boyunca genellikle sabit sayıda alana veya öğeye sahiptir. Daha fazla bilgi Kompozit Türler kısmına bakabilirsin.

Enum

Enum, enumerator (numaralandırıcı) adı verilen ve bir dizi şeyi adlandırmak veya listelemek anlamına gelen enumeration (numaralandırma) sözcüğünün kısaltmasıdır. Enum, Verse’te haftanın günleri veya pusula yönleri gibi şeyler için kullanılabilen bir türdür.

Verse’te enum oluşturma

Büyütmek için görsele tıkla.

Enum oluşturma: enum anahtar sözcüğünü ve ardından {} karakterlerini kullan. Enum’da başlangıç elemanlarını belirlemek istiyorsan, numaralandırıcıları , ile ayırarak {} arasına ekle.

Numaralandırıcıya erişim: Enum üzerinde . ve ardından kullanmak istediğin numaralandırıcıyı kullan. Örneğin, direction.Up şeklinde.

Yapı

Yapı (İngilizce karşılığı olan struct, structure’ın kısaltmasıdır), birbiriyle ilgili birkaç değişkeni birlikte gruplandırmanın bir yoludur. Değişkenler herhangi bir türden olabilir.

Verse’te yeni bir yapı oluşturma

Büyütmek için görsele tıkla.

Verse’te yapı örneği oluşturma

Büyütmek için görsele tıkla.

Yapı oluşturma: struct anahtar sözcüğü ve ardından bir kod bloku kullan. Yapının kod bloku içindeki tanımlar, yapının alanlarını tanımlamaktadır.

Yapı örneği oluşturma: Bir arketipten yapı örneği oluşturabilirsin. Arketip, bir yapının alanlarının değerlerini tanımlar.

Bir yapıdaki alanlara erişme: Bir yapının alanlarına erişebilir ve yapı örneği ile alan adı arasına . ekleyerek değerlerini alabilirsin.

Sınıf

Sınıf, benzer davranış ve özelliklere (değişken ve metotlar) sahip objeler oluşturmaya yönelik bir şablondur; gerçek değerlere sahip bir obje oluşturmak için sınıfın örneği oluşturulmalıdır. Sınıflar hiyerarşiktir, yani bir sınıf, üstünden (üst sınıfından) devralabilir ve bilgilerini altları (alt sınıfları) ile paylaşabilir. Sınıf, kullanıcı tarafından tanımlanan özel bir tür olabilir.

Verse’te yeni bir sınıf oluşturma

Büyütmek için görsele tıkla.

Verse’te bir sınıfın örneğini oluşturma

Büyütmek için görsele tıkla.

Sınıf oluşturma: Bir sınıfın içinde iç içe geçmiş tanımlar, sınıfın alanlarını tanımlamaktadır. Bir sınıfın alanları olarak tanımlanan fonksiyonlar metot olarak da anılır.

Sınıf örneği oluşturma: Sınıf adı ve ardından {} (arketip) kullanarak sınıfın bir örneğini oluşturabilirsin. Arketip, bir sınıfın alanlarının değerlerini tanımlar.

Bir sınıftaki alanlara erişme: Bir yapının alanlarına erişebilir ve sınıf örneği ile alan adı arasına . ekleyerek değerlerini alabilirsin.

Bir sınıftaki metotlara erişme: Bir sınıfın metotlarına erişebilir ve sınıf örneği ile metot adı arasında . metotları çağırabilirsin.

Self: Self ifadesini bir sınıf metodunda kullanarak metodun çağrıldığı sınıfın örneğine başvurabilirsin. Metodun çağrıldığı örneğin diğer alanlarına Self kullanmadan başvurabilirsin ancak örneğe bir bütün olarak başvurmaya ihtiyacın varsa Self kullanman gerekir.

Ayrıca sınıflara özel olan ve davranışlarını değiştirebilen belirleyiciler vardır. Ayrıntılar için Sınıf Belirleyicileri kısmına bak.

Sınıflar hakkında daha fazla bilgi almak için Sınıf kısmına bakabilirsin.

Alt Sınıf

Alt sınıf; diğer bir sınıfın (üst sınıf adı verilir) tanımını genişleten bir sınıftır. Bu genişletme işlemi, diğer sınıfa alan ve metotlar ekleyerek veya bu sınıfın alan ve metotlarını değiştirerek gerçekleşir.

Verse’te yeni bir alt sınıf oluşturma

Büyütmek için görsele tıkla.

Alt sınıf oluşturma: class() ifadesinde () arasına başka bir sınıf ekleyerek, bir sınıfı başka bir sınıfın alt sınıfı olarak belirt.

Üst sınıftaki alanları geçersiz kılma: Yalnızca alan adına <override> belirleyicisini ekleyerek alt sınıf için üst sınıfta tanımlanan bir alanın değerlerini değiştirebilirsin.

Üst sınıftaki metotları geçersiz kılma: [INCLUDE:#overriding_methods_on_superclass_description]

Super: Self ile benzer şekilde, üst sınıfın alan ve metot uygulamalarına erişmek için (super:) kullanabilirsin. (super:) kullanabilmek için alan veya metodun üst sınıf tanımında uygulanması gerekir.

Daha fazla bilgi için Alt Sınıf kısmına bakabilirsin.

Oluşturucu

Oluşturucu, ilişkili olduğu sınıfın bir örneğini oluşturan özel bir fonksiyondur. Yeni objenin başlangıç değerlerini belirlemek için kullanılabilir.

Sınıf için oluşturucu tanımlama: Fonksiyon adına <constructor> belirleyicisini ekleyerek bir sınıf için oluşturucu ekleyebilirsin. Fonksiyon için bir dönüş türü belirlenmesi yerine, fonksiyona sınıf adı atanır, ardından alanlar herhangi bir şekilde başlatılır. Bir sınıfın birden fazla oluşturucusu olabilir.

Oluşturucuda değişken ekleme ve kod yürütme: Bir block ifadesiyle oluşturucu içinde ifadeleri yürütebilir, let anahtar sözcüğüyle yeni değişkenler ekleyebilirsin.

Bir oluşturucuda diğer oluşturucuları çağırma: Bir oluşturucudan diğer oluşturucuları çağırabilirsin. Tüm alanlar başlatıldığı sürece, sınıfın üst sınıfı için oluşturucuları sınıfın bir oluşturucusundan da çağırabilirsin. Bir oluşturucu başka bir oluşturucuyu çağırdığında ve her iki oluşturucu da alanları başlattığında, alanlar için yalnızca ilk oluşturucuya sağlanan değerler kullanılır. İki oluşturucu arasındaki ifadeler için değerlendirme sırası, ifadelerin yazıldığı sırayla aynı olur (yan etkiler bakımından) ancak yalnızca ilk oluşturucuya sağlanan değerler kullanılır.

Arayüz

Arayüz türü, arayüzü uygulayan herhangi bir sınıfla nasıl etkileşime girileceğine yönelik bir sözleşme sağlar. Bir arayüzün örneği oluşturulamaz ancak bir sınıf, arayüzden devralabilir ve onun yöntemlerini uygulayabilir. Arayüz, tanım kapsamında kısmen uygulamaya veya alanlara izin vermemesi dışında soyut sınıf ile benzerdir.

Verse’te arayüz oluşturma

Büyütmek için görsele tıkla.

Verse’te arayüz uygulama

Büyütmek için görsele tıkla.

Arayüz oluşturma: Bir arayüzü, bir sınıf tanımlamaya benzer şekilde tanımlayabilirsin. Burada tek fark interface anahtar sözcüğüdür. Tanımda arayüzle ilişkili metotları belirtebilirsin.

Bir arayüzü genişletme: Bir arayüz, interface() içinde () karakterleri arasında genişletileceği arayüz belirtilerek başka bir arayüzün tanımına genişletilebilir.

Bir arayüzü uygulama: Bir arayüzü, class() içinde () karakterleri arasında arayüzü belirterek bir sınıfla uygulayabilirsin. Sınıf, arayüzde tanımlanan her bir metodu geçersiz kılmalı ve uygulamalıdır.

Birden fazla arayüz uygulama: Bir sınıf birden fazla arayüz uygulayabilir. Arayüzler class() içindeki () karakterleri arasında , ile birbirinden ayrılarak belirtilir.

Bir arayüzden ve başka bir sınıftan devralma: Bir sınıf, bir arayüzü uygulayabilir ve başka bir sınıfın alt sınıfı olabilir. Arayüz ve üst sınıf, class() içindeki () karakterleri arasında , ile birbirinden ayrılarak belirtilir.

Daha fazla bilgi için Arayüz kısmına bakabilirsin.

Türlerle Çalışma

Verse, türlerle çalışmayı kolaylaştıran birkaç yol sunar.

Tür diğer adı: Kodunda bir türe farklı bir ad verebilir ve türü o yeni adla referans alabilirsin. Sözdizimi, sabit başlatma ile benzerdir. Bir fonksiyon türüne de tür diğer adı verebilirsin. Daha fazla bilgi için Tür Diğer Adı kısmına bakabilirsin.

Açık tür bağımsız değişkenleri olarak parametrik tür: Verse, parametrik türleri (bağımsız değişken olarak beklenen türler) destekler. Bu özellik yalnızca sınıflar ve fonksiyonlar ile çalışır. Daha fazla bilgi için Parametrik Türler kısmına bakabilirsin.

Fonksiyonların örtük tür bağımsız değişkenleri olarak parametrik tür: Örtük parametrik türleri fonksiyonlarla birlikte kullanmanın nedeni, kodu fonksiyonun birlikte kullanıldığı her bir tür için yazmak yerine belirli bir tür için değişmez nitelikte kod yazmana olanak tanımasıdır. Daha fazla bilgi için Parametrik Türler kısmına bakabilirsin.

Tür makrosu: Verse rastgele bir ifadenin türünü almak için kullanılabilen özel bir yapıya sahiptir. Bu yapı, türün kullanılabildiği her yerde kullanılabilir. Daha fazla bilgi için Tür Makrosu kısmına bakabilirsin.

subtype: subtype fonksiyonunu bir tür değişkeni üzerinde kısıtlama vermek için kullanabilirsin. Bunun için türün, alt türü oluşturulacak bağımsız değişkenin bir alt türü olan tür değişkeninin yerine geçebilmesi gerekir. Bir Filter çağrısında t yerine geçebilecek herhangi bir şey comparable fonksiyonunun bir alt türü olmak zorundadır.

Daha fazla bilgi için Verse Türleri ile çalışma kısmına bakabilirsin.

İşleçler

İşleçler, Verse programlama dilinde tanımlanan ve işlenenleri üzerinde matematik işlemleri gibi eylemler gerçekleştiren özel işlevlerdir.

Aynı ifadede birden fazla işleç kullanıldığında en yüksekten en düşük önceliğe giden sırayla değerlendirilirler. Aynı ifadede aynı önceliğe sahip işleçler varsa soldan sağa değerlendirilirler.

Aşağıdaki tabloda Verse’teki tüm yerleşik işleçler en yüksekten en düşük önem sırasına göre listeleniyor.

İşleç Açıklama İşleç Formatı işleç önceliği Örnek

? sorgusu

? işleci bir logic değerinin true olup olmadığını kontrol eder. Daha fazla bilgi için Sorgu kısmına bakabilirsin.

sonek

9

TargetLocked?

not değil

not işleci bir ifadenin başarısını veya başarısızlığını olumsuz hale getirir. Daha ayrıntılı bilgi için Not kısmına bakabilirsin.

Önek

8

not TargetLocked?

Pozitif +

+ işlecini, kodunu görsel olarak hizalamaya yardımcı olacak fakat sayının değerini değiştirmeyecek bir sayı öneki olarak kullanabilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

Önek

8

+1

Negatif -

- işlecini, sayı değerini negatif yapan bir sayı öneki olarak kullanabilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

Önek

8

-1

Çarpma *

*, iki sayı değerini birbiriyle çarpar. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

7

2 * 3

Bölme /

/ işleci, birinci sayı işlenenini ikinci sayı işlenenine böler. Tamsayı bölümü başarısız olabilir. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

7

6 / 3

Toplama +

+ işleci iki sayı değerini birbiriyle toplar. Dizeler ve dizilerle birlikte kullanıldığında iki değer birleştirilir. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

6

2 + 3

Çıkarma -

- işleci ikinci sayı işlenenini birinci işlenenden çıkarır. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

6

2 - 3

Toplama atama +=

Bu işleçle toplama ve atamayı aynı işlemde kullanarak bir değişkenin değerini güncelleyebilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

5

set VariableName += 1

Çıkarma atama -=

Bu işleçle çıkarma ve atamayı aynı işlemde kullanarak bir değişkenin değerini güncelleyebilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

5

set VariableName -= 1

Çarpma atama *=

Bu işleçle çarpma ve atamayı aynı işlemde kullanarak bir değişkenin değerini güncelleyebilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

5

set VariableName *= 1

Bölme atama /=

Bu işleçle bölme ve atamayı aynı işlemde kullanarak bir tamsayı olan değişkenin değerini güncelleyebilirsin. Daha ayrıntılı bilgi için Matematik kısmına bakabilirsin.

içtakı

5

set VariableName /= 2

Eşittir =

= işleci, soldaki işlenen sağdaki işlenene eşit olduğunda başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

MyScore = HighScore

Eşit değil <>

<> işleci, soldaki işlenen sağdaki işlenene eşit olmadığında başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

MyScore <> HighScore

Küçüktür <

< işleci, soldaki işlenen sağdaki işlenenden küçük olduğunda başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

MyScore < HighScore

Küçük veya eşittir <=

<= işleci, soldaki işlenen sağdaki işlenene eşit veya ondan küçük olduğunda başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

Score <= HighScore

Büyüktür >

> işleci, soldaki işlenen sağdaki işlenenden büyük olduğunda başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

MyScore > HighScore

Büyük veya eşittir >=

>= işleci, soldaki işlenen sağdaki işlenene eşit veya ondan büyük olduğunda başarılı olur. Aksi takdirde başarısız olur. Daha ayrıntılı bilgi için Karşılaştırma kısmına bakabilirsin.

içtakı

4

MyScore >= HighScore

Ve and

and işleci yalnızca tüm işlenenler başarılı olduğunda başarılı olur. Daha fazla bilgi için And / Or İşleçleri kısmına bakabilirsin.

içtakı

3

Value1 ve Value2

Veya or

or işleci, işlenenlerden en az biri başarılı olursa başarılı olur. Daha fazla bilgi için And / Or İşleçleri kısmına bakabilirsin.

içtakı

2

Value1 veya Value2

Değişken ve sabit başlatma : =

Bu işleçle değerleri bir sabit veya değişkende depolayabilirsin. Daha fazla bilgi için Sabitler ve Değişkenler kısmına bakabilirsin.

içtakı

1

ConstantName := 5

Değişken atama set =

Bu işleçle bir değişkende depolanmış değerleri güncelleyebilirsin. Daha fazla bilgi için Sabitler ve Değişkenler kısmına bakabilirsin.

içtakı

1

set VariableName = 5

Daha fazla bilgi için İşleçler kısmına bakabilirsin.

Gruplandırma

İfadeleri () ile gruplandırarak işleçlerin değerlendirildiği sırayı değiştirebilirsin. Örneğin, (1+2)*3 ve 1+(2*3) aynı şekilde değerlendirilmez çünkü ilk olarak () içinde gruplandırılan ifadeler değerlendirilir.

Aşağıdaki örnekte, verdiği hasarı oyuncudan uzaklığa göre ölçeklendiren ancak oyuncu zırhının toplam hasarı azaltabileceği bir oyun içi patlamayı hesaplamak için gruplandırmanın nasıl kullanılacağı gösteriliyor:

Verse 
BaseDamage : float = 100.0
Armor : float = 15.0
DistanceScaling : float = Max(1.0, Pow(PlayerDistance, 2.0))
ExplosionDamage : float = Max(0.0, (BaseDamage / DistanceScaling) - Armor)

Daha ayrıntılı bilgi için Gruplandırma kısmına bakabilirsin.

Kod blokları

Kod bloku sıfır veya daha fazla ifadeden oluşan bir gruptur ve kapsama alınmış yeni bir gövde ekler. Kod bloğu bir tanımlayıcıyı takip etmelidir. Bu bir fonksiyon tanımlayıcısı veya if ve for gibi bir denetim akışı tanımlayıcısı olabilir.

Aralıklı: : ile başlar ve kod blokundaki her yeni satıra eşit olarak dört boşluk girinti eklenir.

Çok satırlı ayraç içine alınmış: Her ifade yeni bir satırda olacak şekilde {} içine alınır.

Tek satırlı ayraç içine alınmış: Her ifade ile birbirinden ; ile ayrılacak şekilde {} içine alınır.

Ayrıca ; kullanarak bir satıra birden fazla ifade yerleştirmek de mümkündür. Her ifadenin yeni bir satırda olduğu bir formatta {} karakterlerinin kendi satırlarında olmaları gerekmez.

Bir kod bloğundaki son ifade, kod bloğunun sonucudur. Aşağıdaki örnekte IsLightOn? başarılı olursa if ifadesi kod bloku false, IsLightOn? başarısız olursa true olur. Bundan sonra logic sonucu NewLightState içinde depolanır.

Verse 
NewLightState :=
    if (IsLightOn?):
        Light.TurnOff()
        false
    else:
        Light.TurnOn()
        true

Daha fazla bilgi için Kod Blokları kısmına bakabilirsin.

Kapsam

Kapsam bir Verse programında bir tanımlayıcının (ad) bir değer ile ilişkisinin geçerli olduğu ve söz konusu tanımlayıcının değere başvurmak için kullanılabildiği kodu ifade eder.

Örneğin, bir kod bloğu içinde oluşturduğun herhangi bir sabit veya değişken yalnızca o kod bloğunun bağlamında mevcut olur. Buna göre, objelerin yaşam süresi, oluşturuldukları kapsamla sınırlı olur ve bu objeler bu kod bloğunun dışında kullanılamaz.

Aşağıdaki örnekte oyuncunun sahip olduğu para sayısı kullanılarak satın alınabilecek en fazla ok sayısının nasıl hesaplanacağı gösteriliyor. MaxArrowsYouCanBuy sabiti if bloku içinde oluşturulduğu için kapsam if bloku ile sınırlıdır. MaxArrowsYouCanBuy sabiti yazdırma dizesinde kullanıldığında MaxArrowsYouCanBuy adı söz konusu if ifadesinin dışındaki kapsamda mevcut olmadığından bir hata oluşturur.

Verse 
CoinsPerQuiver : int = 100
ArrowsPerQuiver : int = 15
var Coins : int = 225

if (MaxQuiversYouCanBuy : int = Floor(Coins / CoinsPerQuiver)):
    MaxArrowsYouCanBuy : int = MaxQuiversYouCanBuy * ArrowsPerQuiver

Print("You can buy at most {MaxArrowsYouCanBuy} arrows with your coins.") # Error: Unknown identifier MaxArrowsYouCanBuy
Kapsam görselleştirme

Büyütmek için görsele tıkla.

Verse farklı bir kapsamda bildirilmiş olsa da bir tanımlayıcıyı yeniden kullanmayı desteklemez. Bunun istisnası, tanımlayıcının önüne (qualifying_scope:) ekleyerek tanımlayıcıyı uygun hale getirmektir. Burada qualifying_scope; tanımlayıcının modül, sınıf veya arayüzünün adıdır. Tanımlayıcıyı tanımlayıp kullandığın durumlarda niteleyiciyi de tanımlayıcıya eklemen gerekir.

Fonksiyonlar

Fonksiyon, yeniden kullanabileceğin ifadelerin adlandırılmış sekansıdır. Fonksiyon bir eylemin gerçekleştirilmesi veya bir girdiye dayalı bir çıktı oluşturulması için talimatlar sağlayan yeniden kullanılabilir koddur.

Fonksiyon Tanımları

Kendi fonksiyonunu tanımlamak için üç önemli kısmı sağlamak gerekir: bir benzersiz ad (tanımlayıcı), sonucu olarak bekleyebileceğin bilgi türü ve çağırdığında fonksiyonun yapacakları. Bir fonksiyonun temel sözdizimi aşağıdaki gibidir:

Verse 
name() : type =
    codeblock

  • İki noktayla ayrılmış name() ve tür: Fonksiyonu nasıl çağırman ve kullanman gerektiğini belirleyen fonksiyon imzasıdır ve fonksiyonun döndürmesi gereken değer burada belirttiğin türde olur. Bu biçim, kodunda fonksiyonu nasıl çağırdığını taklit eden ve addan sonra gelen () dışında, sabitleri oluşturma şekline benzer.

  • Fonksiyon kod bloku: Fonksiyonun çağrıldığında ne yapacağını, =codeblock değerini belirterek tanımlarsın. Burada codeblock, bir veya daha fazla ifadeden oluşan bir sekanstır. Fonksiyonu her çağırdığında kod bloğu içindeki ifadeler yürütülür.

Verse’te fonksiyon oluşturma

Büyütmek için görsele tıkla.

Fonksiyon Sonuçları

Fonksiyonun için belirtilen bir dönüş türü olduğunda fonksiyon gövdesi o türden bir sonuç üretmelidir. Aksi takdirde kod derlenmez.

Bir değerle döndürülen son ifade: Varsayılan olarak, fonksiyonun kod blokundaki son ifade fonksiyonun sonucudur ve değeri fonksiyonun dönüş türü ile eşleşmelidir.

Bir değerle açık dönüş: return ve ardından bir değerle (örneğin, return HighScore) fonksiyonun ne döndüreceğini açıkça tanımlayabilirsin. return ifadesi, kod blokunda kendisinden sonra daha fazla ifade olsa bile fonksiyondan hemen çıkış yapar.

Sonuç üretmesi gerekmeyen bir fonksiyon oluşturduğunda fonksiyonun dönüş türünü void olarak ayarlayabilirsin. Bunun anlamı, fonksiyonun faydalı bir sonuç üretmesinin beklenmemesidir ve bu yüzden fonksiyonun kod bloku herhangi bir türde olabilir.

return ifadesini tek başına kullanarak dönüş türü void olan bir fonksiyondan çıkabilirsin. Bu ifade, kod bloğunda kendisinden sonra daha fazla ifade olsa bile fonksiyondan hemen çıkış yapar.

Fonksiyon Parametreleri

Bir fonksiyonun girdisi, parametreler kullanılarak tanımlanır. Parametre, daha sonra fonksiyonun gövdesinde kullanabileceğin, parantez içindeki fonksiyon imzasında bildirilen bir sabittir.

İki parametreli bir fonksiyonun sözdizimi aşağıdaki gibidir:

Verse 
name(parameter1name : type, parameter2name : type) : type =
    codeblock
Verse’te parametrelerle fonksiyon oluşturma

Büyütmek için görsele tıkla.

Aşağıdaki örnekte IncreaseScore() fonksiyonu, fonksiyonun MyScore değerini artırmak için kullandığı Points adlı bir tamsayı parametresine sahiptir:

Verse 
var MyScore : int = 100

IncreaseScore(Points : int) : void =
    # Increase MyScore by Points.
    set MyScore = MyScore + Points

Fonksiyon Çağrıları

Kodunda adlandırılmış ifade sıralamasını (fonksiyon) kullanmak istediğinde fonksiyonu, 1 ile 10’u da kapsayan aralıkta rastgele bir tamsayı döndüren GetRandomInt(1, 10) gibi, bir adla çağırman gerekir.

Fonksiyon çağrısının başarısız olabilir özellikte olup olmamasına bağlı olarak bir fonksiyonu çağırmanın iki yolu vardır:

Başarısız olamaz fonksiyon çağrısı: Başarısız olamaz bir fonksiyon çağrısı FunctionName() biçimindedir.

Başarısız olabilir fonksiyon çağrısı: Başarısız olabilir bir fonksiyon çağrısı FunctionName[] biçimindedir. Bir fonksiyon tanımında decides belirleyicisi olduğunda fonksiyon başarısız olabilir olarak işaretlenir.

Fonksiyon Bağımsız Değişkenleri

Parametreleri bekleyen bir fonksiyon çağırdığında tıpkı sabitleri kullanabilmek için onlara değer atamanın gerekli olması gibi parametrelere değerler ataman gerekir. Atanan değerler, fonksiyonun bağımsız değişkenleri olarak adlandırılır.

İki bağımsız değişkenli bir fonksiyonu çağırmanın sözdizimi aşağıdaki gibidir:

Verse 
name(parameter1name := value, parameter2name := value)

Aşağıdaki örnekte IncreaseScore() fonksiyonu, MyScore değerini artırmak için her defasında farklı bağımsız değişkenlerle (10, 5 ve 20) olacak şekilde üç kez çağrılır.

Verse 
# After this call, MyScore is 110
IncreaseScore(Points := 10)

# After this call, MyScore is 115
IncreaseScore(Points := 5)

# After this call, MyScore is 135
IncreaseScore(Points := 20)

Uzantı Metotları

Genişletme metotları, var olan bir sınıfın veya türün üyeleri gibi hareket eden ancak yeni bir tür veya alt sınıf oluşturulmasını gerektirmeyen bir fonksiyon türüdür.

int türündeki diziler için uzantı metodunun nasıl oluşturulacağı aşağıda gösterilmektedir. Yöntem, dizideki tüm sayıları toplar ve toplamı döndürür.

Verse 
    # Sum extension method for type []int
    (Arr : []int).Sum<public>() : int =
        var Total : int = 0
        for (Number : Arr):
            set Total = Total + Number
        return Total

Metot daha sonra int türündeki herhangi bir dizide çağrılabilir.

Verse 
    SumTotal := array{4, 3, 7}.Sum()
    Print("The SumTotal is { SumTotal }")

    # "The SumTotal is 14"

Hata

Bir programın akışını değiştirmek için true ve false Boole değerlerini kullanan diğer programlama dillerinin aksine, Verse başarılı veya başarısız olabilen ifadeler kullanır. Bu ifadeler başarısız olabilir ifadeler olarak adlandırılır ve yalnızca bir başarısızlık bağlamında yürütülebilir.

Başarısız Olabilir İfadeler

Başarısız olabilir bir ifade, başarılı olup bir değer üreten veya başarısız olup değer üretmeyen bir ifadedir.

Aşağıdaki liste Verse’teki tüm başarısız olabilir ifadeleri içerir:

Fonksiyon çağrıları: Yalnızca fonksiyon çağrısı FunctionName[] biçiminde olduğunda ve fonksiyon tanımında decides belirleyicisi bulunduğunda.

Karşılaştırma: Bir karşılaştırma ifadesi, karşılaştırma işleçlerinden birini kullanarak iki şeyi karşılaştırır. Daha fazla bilgi için işleçler kısmına bakabilirsin.

Tamsayı bölme: Tamsayılar için / bölme işleci başarısız olabilir ve başarılı olursa sonuç rational türündedir. Daha fazla bilgi için işleçler kısmına bakabilirsin.

Karar: Karar ifadesi, başarı ve başarısızlık karar akışını kontrol edebilmeni sağlayan not, and veya or işleçlerini kullanır. Daha fazla bilgi için işleçler kısmına bakabilirsin.

Sorgu: Sorgu ifadesi ? işlecini kullanır ve bir logic veya option değerinin true olup olmadığını kontrol eder. Aksi takdirde ifade başarısız olur. Daha fazla bilgi için işleçler kısmına bakabilirsin.

Dizideki bir elemana erişme: Dizinde bir eleman olmayabileceğinden ilgili dizide depolanmış değere erişmek başarısız olabilir ifadedir ve bu nedenle bir başarısızlık bağlamında kullanılmalıdır. Daha ayrıntılı bilgi için dizi kısmına bakabilirsin.

Başarısızlık Bağlamları

Hata bağlamı, başarısız olabilir ifadelerin yürütülmesine izin verilen bir bağlamdır. Bağlam, ifadenin başarısız olması durumunda ne olacağını tanımlar. Bir başarısızlık bağlamındaki herhangi bir başarısızlık tüm bağlamın başarısız olmasına neden olur.

Başarısızlık bağlamı, iç içe ifadelerin bir block ifadesindeki fonksiyon bağımsız değişkenleri veya ifadeler gibi başarısızlık ifadeleri olmasına izin verir.

Aşağıdaki liste Verse’teki tüm hata bağlamlarını içerir:

if ifadelerindeki koşul.

for ifadelerindeki yineleme ifadeleri ve filtre ifadeleri.

decides efekt belirleyicisine sahip fonksiyonun gövdesi.

not işlecinin işleneni.

or işlecinin sol işleneni.

option türüne sahip bir değişken başlatma.

spekülatif yürütme

Verse’te başarısızlık bağlamlarının faydalı bir yönü, eylemleri işlemeden deneyebileceğin anlamına gelen bir tür kurgusal yürütme şekli olmalarıdır. Bir ifade başarılı olduğunda ifadenin efektleri işlenir. Buna örnek olarak bir değişkenin değerinin değiştirilmesi gösterilebilir. Öte yandan ifade başarısız olursa ifadenin efektleri sanki ifade hiç gerçekleşmemiş gibi geri alınır.

Bu yöntemle, değişiklikleri biriktiren bir dizi eylem yürütebilirsin ancak bu eylemler hata bağlamının herhangi bir yerinde başarısız olursa geri alınacaktır.

Bunun işe yaraması için hata bağlamında çağrılan tüm fonksiyonlar transacts efekt belirleyicisine sahip olmak zorundadır.

Belirleyiciler

Verse’te belirleyiciler, semantik ile ilgili davranışı açıklar ve tanımlayıcılara ve belirli anahtar sözcüklere eklenebilir. Belirleyici sözdizimi, < ile > kullanarak anahtar sözcüğü bunların arasına koyar. Örneğin IsPuzzleSolved()<decides><transacts> : void.

Aşağıdaki bölümlerde Verse’teki tüm belirleyiciler ve bunları ne zaman kullanabileceğin açıklanıyor.

Efekt Belirleyicileri

Verse’te efektler bir fonksiyonun sergilemesine izin verilen davranış kategorilerini belirtir. Efekt belirleyicileri şunlara ekleyebilirsin:

  • Bir fonksiyon tanımındaki addan sonra gelen (): name()<specifier> : type = codeblock.

  • class anahtar sözcüğü: name := class<specifier>():.

Efekt belirleyiciler iki kategoriye ayrılır:

  • Özel: Bir fonksiyona veya class anahtar sözcüğüne özel efekt belirleyicilerinden yalnızca birini ekleyebilirsin veya hiçbirini ekleyemezsin. Özel bir efekt belirleyicisi eklenmezse varsayılan efekt no_rollback şeklinde olur.

  • Katkı: Bir fonksiyona veya class anahtar sözcüğüne katkı efekti belirleyicilerinin tümünü veya bazılarını ekleyebilirsin ya da hiçbirini ekleyemezsin.

Örnek Etki

no_rollback: Özel bir efekt belirtilmediğinde varsayılan efekttir. no_rollback efekti, fonksiyon tarafından gerçekleştirilen hiçbir eylemin geri alınamayacağını ve bu nedenle fonksiyonun bir başarısızlık bağlamında kullanılamayacağını belirtir. Bu efekt manuel olarak belirtilemez.

Özel Efektler

transacts: Bu efekt, fonksiyon tarafından gerçekleştirilen herhangi bir eylemin geri alınabileceğini belirtir. transacts efekti, bir değiştirilebilir değişkenin (var) yazıldığı her durumda gereklidir. transacts efekti geri alınamayan bir fonksiyona eklendiyse kodunu derlerken sana bildirilecektir. Bu kontrol native belirleyicisine sahip fonksiyonlar için yapılmaz.

varies: Bu efekt, fonksiyona eklenen aynı girdinin her zaman aynı çıktıyı üretemeyebileceğini belirtir. varies efekti aynı zamanda fonksiyon davranışının içerdiği paketin yeni sürümleriyle aynı kalmasının garanti edilemeyeceğini belirtir.

computes: Bu efekt, fonksiyonun yan efektlerinin olmamasını gerektirir ve her zaman tamamlanmayabilir. Aynı bağımsız değişkenlerle birlikte sağlandığında fonksiyonun aynı sonucu vermesine yönelik denetlenmemiş bir gereklilik vardır. native belirleyicisine sahip olmayan ve aksi durumda converges efektine sahip olacak bir fonksiyon, computes efektini kullanmaya güzel bir örnektir.

converges: Bu efekt, ilgili fonksiyonun yürütülmesinden kaynaklanan bir yan efekt olmayacağını ve fonksiyonun kesin olarak tamamlanacağını (sonsuz kadar yinelenmemesini) garanti eder. Bu efekt yalnızca native belirleyicisine sahip fonksiyonlarda görünebilir ancak bunun gerçekleşmesi derleyici tarafından denetlenmez. Bu efektin gerçekleşmesi için varsayılan sınıf değerlerinin sağlanması için kullanılan kod veya global değişken değerleri gereklidir. sin(), cos() ve tan() fonksiyonları, converges efektine sahip fonksiyonlara örnektir.

Katkı Efektleri

decides: Fonksiyonun başarısız olabileceğini ve bu fonksiyonu çağırmanın başarısız olabilir bir ifade olduğunu belirtir. decides efektine sahip fonksiyon tanımları aynı zamanda transacts efektine sahip olmalıdır. Bunun anlamı, fonksiyonun herhangi bir yerinde bir hata olursa bu fonksiyon tarafından gerçekleştirilen eylemlerin (eylemler hiç gerçekleştirilmemiş gibi) geri alınabileceğidir.

suspends: Fonksiyonun asenkron olduğunu belirtir. Fonksiyon gövdesi için bir asenk. bağlamı oluşturur.

Tüm durumlarda belirli bir efekte sahip bir fonksiyonu çağırmak için çağıranın da o efekte sahip olması gerekir.

Erişim Belirleyicileri

Erişim belirleyiciler bir üye ile neyin nasıl etkileşimde bulunabileceğini tanımlar. Erişim belirleyiciler aşağıdakilere uygulanabilir:

  • Bir üye için tanımlayıcı: name<specifier> : type = value

  • Bir üye için var anahtar sözcüğü: var<specifier> name : type = value

Sınıf Belirleyicileri

Sınıf belirleyiciler, sınıfların veya üyelerinin, bir sınıfın alt sınıfını oluşturup oluşturamayacağın gibi belirli özelliklerini tanımlar.

abstract: Bir sınıf veya sınıf metodunda abstract belirleyicisi olduğunda sınıfın örneğini oluşturamazsın. Soyut sınıflar, kısmi uygulamalı bir üst sınıf veya ortak bir arayüz olarak kullanılmaya yöneliktir. Bu anlayış, bir üst sınıfın örneklerine sahip olmanın mantıklı olmadığı ancak özellikleri ve davranışları benzer sınıflar arasında tekrar etmek istemediğin durumlar için faydalıdır.

concrete: Bir sınıfta concrete belirleyicisi olduğunda sınıfı boş bir arketiple oluşturmak mümkündür. Bunun sonucunda sınıfın her alanı varsayılan bir değere sahip olmak zorundadır. Bir somut sınıfın her alt sınıfı örtük olarak somuttur. Bir somut sınıfın bir soyut sınıftan doğrudan devralabilmesi için her iki sınıfın da aynı modülde tanımlanmış olması gerekir.

unique: unique belirleyicisi, bir sınıfı benzersiz yapmak için sınıfa uygulanabilir. Verse, benzersiz bir sınıfın bir örneğini oluşturmak için ortaya çıkan örneğe benzersiz bir kimlik ayırır. Bu işlem, benzersiz sınıf örneklerinin, kimlikleri karşılaştırılmak suretiyle eşitlik açısından karşılaştırılmasına imkan tanır. Benzersiz belirleyicisi olmayan sınıfların böyle bir kimliği yoktur, dolayısıyla bunlar eşitlik açısından yalnızca alanlarının değerlerine göre karşılaştırılabilir. Buna göre, benzersiz sınıflar = ve <> işleçleriyle karşılaştırılabilir, ayrıca karşılaştırılabilir türün alt türleridir.

Uygulama Belirleyicileri

Kod yazarken uygulama belirleyicileri kullanmak mümkün değildir ancak UEFN API’lerine baktığında bunları göreceksin.

native_callable: Bir örnek metodunun hem yerel (C++ dilinde uygulanan) olduğunu hem de diğer C++ kodlarıyla çağrılabileceğini belirtir. Bu belirleyicinin bir örnek yönteminde kullanıldığını görebilirsin. Bu belirleyici alt sınıflara yayılmaz, dolayısıyla bu belirleyiciye sahip bir metodu geçersiz kılarken onu bir tanıma eklemen gerekmez.

Yerelleştirme Belirleyicisi

Yeni bir mesaj tanımlarken localizes belirleyicisini kullanman gerekir. Bu özellikle, değişken message türüne sahip olduğunda ve değişkeni bir string değeri ile başlatacağın zaman gereklidir.

Verse 
# The winning player's name:
PlayerName<localizes> : message = "Player One"
Verse 
# Build a message announcing the winner.
Announcement<localizes>(WinningPlayerName : string) : message = "...And the winner is: {WinningPlayerName}"

Billboard.SetText(Announcement("Player One"))

Daha önce oluşturulmuş bir mesajla bir üye değeri başlatırken localizes belirleyicisini kullanman gerekmez çünkü localizes belirleyicisi yalnızca yeni mesajlar içindir.

Verse 
PlayerOne<localizes> : message = "Player One"

# The winning player's name:
PlayerName : message = PlayerOne

Öznitelikler

Verse’te öznitelikler, Verse dilinin dışında kullanılan davranışı açıklar (Verse semantiğini açıklayan belirleyicilerin aksine). Öznitelikler, kod satırında tanımların önüne eklenebilir.

Öznitelik sözdizimi, @ ve ardından anahtar sözcük kullanır.

denetim akışı

Denetim akışı bir bilgisayarın talimatları yürütme sırasıdır. Verse, programında bu akışı kontrol etmek için kullanabileceğin farklı ifadelere sahiptir.

Blok

Verse bir kod blokundan önce bir tanımlayıcı gerektirdiğinden block ifadeleri kod bloklarını nasıl iç içe yerleştirdiğini ifade eder. İç içe yerleştirilmiş kod bloğu, bir kod bloğuna benzer şekilde davranır. Kod bloklarında olduğu gibi blok ifadesi de yeni bir iç içe kapsam gövdesi sunar.

blok

Sonuç: block kod blokundaki son ifade. Bu örnekte block ifadesinin sonucu, expression2 ifadesinin sonucudur.

Daha fazla bilgi için Blok kısmına bakabilirsin.

If

if ifadesiyle programın akışını değiştiren kararlar verebilirsin. Diğer programlama dillerinde olduğu gibi Verse’teki if ifadesi de koşullu yürütmeyi destekler ancak Verse’te koşullar kararı yönlendirmek için başarı ve başarısızlığı kullanır.

If if ... then

Sonuç: if kod blokundaki son ifade. Bu örnekte if ifadesinin sonucu, expression1 ifadesinin sonucudur.

Sonuç: if kod blokundaki son ifade. Bu örnekte if ifadesinin sonucu, expression1 ifadesinin sonucudur.

if ... else if ... else if ... else

Aşağıdaki örnekte IsLightOn? başarılı olursa if ifadesi kod bloku false, IsLightOn? başarısız olursa true olur. Bundan sonra logic sonucu NewLightState içinde depolanır.

Verse 
NewLightState :=
    if (IsLightOn?):
        Light.TurnOff()
        false
    else:
        Light.TurnOn()
        true

Verse’te if ifadesinin faydalarından biri, başarısız olabilir ifadeleri denemene olanak verilmesi ve başarısız olurlarsa eylemlerin hiç gerçekleşmemiş gibi geri alınabilmesidir. Bu özellik hakkında daha fazla bilgi için Kurgusal Yürütme kısmına bakabilirsin.

Daha fazla bilgi için If kısmına bakabilirsin.

Case

case ifadeleri ile bir programın akışını seçenek listesinden denetleyebilirsin. Verse’te case deyimi, bir değeri birden çok olası değere karşı test etmeye (= kullanıyormuşsun gibi) ve hangisinin eşleştiğine göre kod çalıştırmaya olanak tanır.

kılıf

Daha fazla bilgi için Case kısmına bakabilirsin.

Loop

loop ifadesiyle döngü blokundaki ifadeler, döngünün her yinelemesi için tekrar edilir.

döngü

Sonuç: Bir loop ifadesinin sonucu void olur, yani faydalı bir sonuç üretmez.

Aşağıdaki örnekte oyun devam ettikçe her ToggleDelay değeri kadar saniyede bir platform görünür ve kaybolur.

Verse 
loop:
    Sleep(ToggleDelay) # Sleep(ToggleDelay) waits for ToggleDelay seconds before proceeding to the next instruction.
    Platform.Hide()
    Sleep(ToggleDelay)
    Platform.Show() # The loop restarts immediately, calling Sleep(ToggleDelay) again.

Daha fazla bilgi için Loop kısmına bakabilirsin.

Döngüleri Durdurma

Bir loop bloku sonsuza kadar devam eder. Döngüyü durdurmak için break ile veya fonksiyonun return ifadesi ile döngüden çıkış yapabilirsin.

Döngü ve Kesme loop ve return

Sonuç: Bir loop ifadesinin sonucu void olur, yani faydalı bir sonuç üretmez.

Sonuç: Bir loop ifadesinin sonucu void olur, yani faydalı bir sonuç üretmez.

iç içe loop ve break

Sonuç: Bir loop ifadesinin sonucu void olur, yani faydalı bir sonuç üretmez.

Daha fazla bilgi için Loop ve Break kısmına bakabilirsin.

For

Bazı durumlarda for döngüsü olarak adlandırılan for ifadesi bir loop ifadesiyle aynıdır ancak for ifadeleri her defasında bir değer olmak üzere bir değer sekansı üretmek için üreteç kullanır ve her değere bir ad verir.

Örneğin for(Value : 1..3) ifadesi 1, 2, 3 sıralamasını oluşturur ve sıralamadaki her bir sayıya her yineleme için Value adı verilir. Böylece for döngüsü üç kez çalışır.

for ifadesi iki kısımdan oluşur:

  • Yineleme belirtimi: Parantez içindeki ifadeler. Birinci ifade bir oluşturucu olmalıdır ancak diğer ifadeler bir sabit başlatma veya filtre olabilir.

  • Gövde: Kod blokundaki parantezden sonra gelen ifadeler.

için filtreli for

Sonuç: for ifadesinin sonucu, her bir yineleme kod blokunun sonucunu içeren bir dizidir.

Sonuç: for ifadesinin sonucu, her bir yineleme kod blokunun sonucunu içeren bir dizidir.

birden fazla üreteçli for iç içe for blokları

Sonuç: for ifadesinin sonucu, her bir yineleme kod blokunun sonucunu içeren bir dizidir.

Sonuç: İç içe for ifadesine sahip bir for ifadesinin sonucu, iç döngünün kod blokundan her bir yinelemenin sonuç dizisini içeren bir dizidir.

Daha fazla bilgi için For kısmına bakabilirsin.

ertelemek

defer ifadesi, return ifadesinde olduğu gibi herhangi bir sonuç ifadesi de dahil olmak üzere, program denetimini defer ifadesinin belirdiği kapsamın dışına aktarmadan hemen önce yürütülür. Program denetiminin nasıl aktarıldığı önemli değildir.

ertelemek çıkıştan önce defer

Sonuç: defer ifadesinin sonucu yoktur.

Sonuç: defer ifadesinin sonucu yoktur.

Defer ile karşılaşılmadan önce erken bir çıkış gerçekleşirse defer ifadesi yürütülmez.

erken dönüş ile defer iptal edilmiş bir eşzamanlı görev ile defer

Sonuç: defer ifadesinin sonucu yoktur.

Sonuç: defer ifadesinin sonucu yoktur.

Aynı kapsamda görünen birden fazla defer ifadesi birikir. İfadelerin yürütüldüğü sıra, karşılaşıldığı sıranın tersidir: ilk giren son çıkar (FILO) sırası. Belirli bir kapsamda karşılaşılan son defer ilk önce yürütülür, bu son karşılaşılan defer içindeki ifadeler daha önce karşılaşılan ve daha sonra yürütülen diğer defer ifadeleri tarafından temizlenecek bağlama başvurabilir.

Bir kod blokunda birden fazla defer ifadesi. Farklı kod bloklarında birden fazla defer ifadesi.

Sonuç: defer ifadesinin sonucu yoktur.

Sonuç: defer ifadesinin sonucu yoktur.

Zaman Akışı ve Eşzamanlılık

Zaman akışı kontrolü, Verse programlama dilinin ana unsurlarından biridir ve eşzamanlı ifadelerle gerçekleştirilir. Eşzamanlılık hakkında daha fazla bilgi almak için Eşzamanlılığa Genel Bakış kısmına bakabilirsin.

yapılandırılmış eşzamanlılık

Yapılandırılmış eşzamanlılık ifadeleri, asenkron zaman akışını belirtmek ve asenkron ifadelerin engelleyici niteliğini belirli bir asenkron bağlam kapsamına (bir asenkron fonksiyon gövdesi gibi) kısıtlı bir yaşam süresi ile değiştirmek için kullanılır.

Bu, ilişkili kapsamlarıyla kısıtlanan block, if, for ve loop gibi yapılandırılmış kontrol akışına benzer.

senk Dal

Kod blokundaki tüm ifadeleri eşzamanlı olarak yürütür ve senkronizasyondan bir sonraki ifadeyi yürütmeden önce hepsinin tamamlanmasını bekler.

branch ifadesinin gövdesini, karşılaşıldığı anda başlatılır. Branch ifadesinin gövdesi, kod bloku veya çevresindeki asenkron bağlam tamamlanana kadar (hangisi daha önce gerçekleşirse) değerlendirmeye devam eder ve bu şartlardan biri sağlandığında branch kod bloku iptal edilir.

Sonuç: Bir sync ifadesinin sonucu, en üst seviyedeki ifadelerin belirtildiği sırayla her bir ifadeden alınan sonuçların bir demetidir. İfadelerin sonuç türleri herhangi bir türde olabilir ve her demet elemanı, kendisine karşılık gelen ifadenin türünde olur.

Sonuç: branch ifadesinin bir sonucu olmadığı için sonuç türü void olur.

race rush

sync ifadesiyle benzerdir ancak “kazanan” alt ifade dışında her şeyi iptal eder. Diğer ifadelerin herhangi biri önceki ifadeyle aynı simülasyonda tamamlanırsa birinci (daha önceki) ifade "kazanır" ve herhangi bir beraberliği bozar. “Kaybeden” ifade görevleri iptal edilir.

race ifadesine benzer ancak birinci ifade tamamlandıktan sonra tamamlanan ifadeler yürütülmeye devam eder. Herhangi bir ifade aynı simülasyon güncellemesinde etkili bir şekilde tamamlanırsa daha önce karşılaşılıp tamamlanan ifade herhangi bir beraberliği bozar. Tamamlanmamış tüm ifadeler tamamlanana kadar veya çevrelerindeki asenkron bağlam tamamlanana kadar (hangisi önce gerçekleşirse) değerlendirmeye devam eder ve bu şartlardan biri sağlandığında kalan tüm kaybeden ifadeler iptal edilir.

Sonuç: Bir race ifadesinin sonucu, tamamlanan ilk ifadenin sonucudur. Sonuç türü, kod blokundaki tüm ifadelerin en yaygın uyumlu türüdür.

Sonuç: Bir rush ifadesinin sonucu, tamamlanan ilk ifadenin sonucudur. Sonuç türü, kod blokundaki tüm ifadelerin en yaygın uyumlu türüdür.

yapılandırılmamış eşzamanlılık

Yapılandırılmamış eşzamanlılık ifadeleri (sadece spawn bu türdendir), belirli bir asenk. bağlam kapsamıyla sınırlı olmayan ve yürütüldüğü kapsamın ötesine genişleme potansiyeli barındıran bir yaşam süresine sahiptir.

Çıkar

Bir spawn ifadesinin gövdesi, bir asenkron fonksiyonun gövdesi gibi asenkron bağlam oluşturur. Ancak spawn gövdesi içinde yalnızca tek bir asenkron fonksiyon çağrısına izin verilir. Asenkron spawn fonksiyonu karşılaşıldığı anda başlatılır ve askıya alan veya engelleyen bir şeyle karşılaşana kadar değerlendirmeye devam eder. Ortaya çıkan asenkron fonksiyon, ortaya çıktığı konumla başka bir bağlantı kurmadan tamamlanana kadar değerlendirmeye devam eder.

Sonuç: spawn bir görev sonucuna (task(type)) sahiptir.

Task

Görev (task), o sırada yürütülmekte olan asenk. bir fonksiyonun durumunu göstermek için kullanılan bir objedir. Görev objeleri, asenk. bir fonksiyonun nerede askıya alındığını ve söz konusu askıya alma noktasındaki yerel değişkenlerin değerlerini belirlemek için kullanılır.

Verse 
# Get task to query / give commands to
# starts and continues independently
Task2 := spawn{Player.MoveTo(Target1)}
Task2.Await() # wait until MoveTo() completed

Modüller ve Yollar

Verse modülü, yeniden dağıtılabilen ve bağımlı olunabilen atomik bir kod birimidir ve bağımlılıkları bozmadan zaman içinde gelişebilir. Diğer Verse dosyalarındaki kod tanımlarını kullanmak için Verse dosyan içine bir modül aktarabilirsin.

using: Bir Verse modülünün içeriğini kullanabilmek için modülü yoluna göre belirtmen gerekir.

module: Bir projedeki klasörlere göre sunulan modülün dışında, modüller .verse dosyası içinde module anahtar sözcüğü kullanılarak oluşturulabilir.

Daha fazla bilgi için Modüller ve Yollar kısmına bakabilirsin.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page