Vector  - AS3

Vector öğesinin length özelliğinin değiştirilip değiştirilemeyeceğini belirtir. Değer true olursa, length özelliği değiştirilemez. Başka bir deyişle, fixed öğesi true olduğunda şu işlemlere izin verilmez:

• length özelliğini doğrudan ayarlama
• length dizin konumuna bir değer atama
• length özelliğini değiştiren ve aşağıda örnekleri yer alan bir yöntemi çağırma:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (splice() çağrısı Vector öğesinin length özelliğini değiştirirse).

Vector içindeki kullanılabilir geçerli dizinlerin aralığı. Bir Vector örneği, length değeri hariç, bu değere kadar olan dizin konumlarına sahiptir.

Her Vector öğesi daima taban türü örneği olan veya null olan bir değere sahiptir. length özelliği, bir önceki değerinden daha büyük bir değere ayarlandığında, ek öğeler oluşturulur ve taban türü için uygun varsayılan değerle (başvuru türleri için null) doldurulur.

length özelliği, bir önceki değerinden daha küçük bir değere ayarlandığında, yeni length değerinden büyük veya bu değere eşit olan dizin konumlarındaki tüm öğeler Vector öğesinden kaldırılır.

Belirtilen taban türüyle bir Vector oluşturur.

Vector.<T>() yapıcısını çağırırken type parametresi sözdizimini kullanarak taban türünü belirtin. Type parametresi sözdizimi, aşağıdaki örnekte gösterildiği gibi bir nokta (.), sol açılı ayraç (<), sınıf adı, daha sonra sağ açılı ayraçtan oluşan (>) bir dizidir:

     var v:Vector.<String> = new Vector.<String>();
     

Başka bir Vector örneği (örn. farklı taban türünde) veya bir Array örneğinden Vector oluşturmak için Vector() global işlevini kullanın.

Önceden doldurulan bir Vector örneği oluşturmak için aşağıda belirtilen parametreler yerine aşağıdaki sözdizimini kullanın.

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

Aşağıdaki bilgiler bu sözdizimi için geçerlidir:

• Bu, Flash Professional CS5 ve sonrası, Flash Builder 4 ve sonrası ve Flex 4 ve sonrasında desteklenir.
• Son virgül isteğe bağlıdır.
• Dizideki boş öğeler desteklenmez; var v:Vector.<int> = new <int>[0,,2,] gibi bir ifade bir derleyici hatası atar.
• Vector örneği için varsayılan bir uzunluk belirtemezsiniz. Uzunluk, başlatma listesindeki öğe sayısı kadardır.
• Vector örneğinin sabit bir uzunluğa sahip olup olmadığını belirtemezsiniz. Onun yerine, fixed özelliğini kullanın.
• Değerler olarak iletilen öğeler belirtilen türle eşleşmezse veri kaybı veya hatalar oluşabilir. Örneğin:

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

İlgili API Öğeleri

Parametre listesinde belirtilen Vektörleri bu Vektör örneğindeki öğelerle birleştirir ve yeni bir Vektör oluşturur. Parametre listesindeki Vektörlerin bu Vektörle aynı taban türünde veya alt türünde olması gerekir. Herhangi bir parametre iletmezseniz, döndürülen Vektör orijinal Vektörün aynısıdır (basit kopya).

Parametreler

Belirtilen işlev için false döndüren bir öğeye ulaşılıncaya kadar Vector örneğindeki her öğede bir test işlevi çalıştırır. Bir Vector örneğindeki tüm öğelerin belirli bir sayıdan daha az değere sahip olma gibi bir ölçütü karşılayıp karşılamadığını belirlemek için bu yöntemi kullanabilirsiniz.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. Bu, söz konusu yöntemin en yaygın kullanım şeklidir.

Flash Professional'ı kullanarak ana zaman çizelgesinde bir işlev oluşturduğunuzu ancak bunun farklı bir this bağlamında çağrılmasını istediğinizi varsayın:

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Daha sonra da myVector adındaki bir Vector örneğinde every() yöntemini kullanacağınızı varsayın:

    myVector.every(myFunction, someObject);
    

myFunction, SWF dosyasının ana sınıfının bir üyesi olduğundan, farklı bir this bağlamında çalıştırılamaz. Bu kod çalıştığında Flash çalışma zamanları bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

Parametreler

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

İlgili API Öğeleri

Vector örneğindeki her öğede bir test işlevini çalıştırır ve belirtilen işlev için true döndüren tüm öğeleri içeren yeni bir Vector örneği döndürür. Bir öğe false döndürürse, sonuç Vector örneğine dahil edilmez. Dönüş Vector örneğinin taban türü, üzerinde yöntemin çağrıldığı Vector örneğinin taban türüyle eşleşir.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. Bu, söz konusu yöntemin en yaygın kullanım şeklidir.

Flash Professional'ı kullanarak ana zaman çizelgesinde bir işlev oluşturduğunuzu ancak bunun farklı bir this bağlamında çağrılmasını istediğinizi varsayın:

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Daha sonra da myVector adındaki bir Vector örneğinde filter() yöntemini kullanacağınızı varsayın:

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

myFunction, SWF dosyasının ana sınıfının bir üyesi olduğundan, farklı bir this bağlamında çalıştırılamaz. Bu kod çalıştığında Flash çalışma zamanları bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

Parametreler

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

İlgili API Öğeleri

Bir işlevi Vector örneğindeki her öğe üzerinde çalıştırır.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. Bu, söz konusu yöntemin en yaygın kullanım şeklidir.

Flash Professional'ı kullanarak ana zaman çizelgesinde bir işlev oluşturduğunuzu ancak bunun farklı bir this bağlamında çağrılmasını istediğinizi varsayın:

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

Daha sonra da myVector adındaki bir Vector örneğinde forEach() yöntemini kullanacağınızı varsayın:

     myVector.forEach(myFunction, someObject);
     

myFunction, SWF dosyasının ana sınıfının bir üyesi olduğundan, farklı bir this bağlamında çalıştırılamaz. Bu kod çalıştığında Flash çalışma zamanları bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

Parametreler

function callback(item:T, index:int, vector:Vector.<T>):void;

Vector örneğinde bir öğeyi arar ve öğenin dizin konumunu döndürür. Katı eşitlik (===) kullanılarak öğe Vector öğeleriyle karşılaştırılır.

Parametreler

İlgili API Öğeleri

Vektöre tek bir öğe ekleyin. Bu yöntem, kopya oluşturmadan Vector öğesini değiştirir.

Parametreler

Vector örneğindeki öğeleri dizelere dönüştürür, öğeler arasına belirtilen ayırıcıları ekler, bunları birleştirir ve sonuç dizesini döndürür. Yuvalanmış bir Vector, join() yöntemine iletilen ayırıcı ile değil, her zaman virgülle (,) ayrılır.

Parametreler

İlgili API Öğeleri

Belirtilen dizin konumundan geriye doğru çalışarak Vector öğesinde bir öğeyi arar ve eşleşen öğenin dizin konumunu döndürür. Katı eşitlik (===) kullanılarak öğe Vector öğeleriyle karşılaştırılır.

Parametreler

İlgili API Öğeleri

Vector örneğindeki her öğede bir işlevi çalıştırır ve bu Vector örneğindeki her öğede işlev çağrısının sonuçlarına karşılık gelen öğelerin yeni bir Vector öğesini döndürür. Sonuç Vector öğesi, orijinal Vector ile aynı taban türüne ve length özelliğine sahiptir. Sonuç Vector öğesinde i dizinindeki öğe, orijinal Vector öğesinde i dizinindeki öğede yapılan çağrının sonucudur.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. Bu, söz konusu yöntemin en yaygın kullanım şeklidir.

Flash Professional'ı kullanarak ana zaman çizelgesinde bir işlev oluşturduğunuzu ancak bunun farklı bir this bağlamında çağrılmasını istediğinizi varsayın:

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

Daha sonra da myVector adındaki bir Vector örneğinde map() yöntemini kullanacağınızı varsayın:

     myVector.map(myFunction, someObject);
     

myFunction, SWF dosyasının ana sınıfının bir üyesi olduğundan, farklı bir this bağlamında çalıştırılamaz. Bu kod çalıştığında Flash çalışma zamanları bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

Parametreler

function callback(item:T, index:int, vector:Vector.<T>):T;

İlgili API Öğeleri

Vector öğesinden son öğeyi kaldırır ve o öğeyi döndürür. Bu işlev çağrıldığında, Vector öğesinin length özelliği bir azaltılır.

İlgili API Öğeleri

Vector öğesinin sonuna bir veya daha fazla öğe ekler ve Vector öğesinin yeni uzunluğunu döndürür.

Bu işlev birden çok argümanı kabul edebildiğinden, argümanların veri türü katı modda bile derleme zamanında kontrol edilmez. Ancak taban türünün örneği olmayan bir argüman iletilirse, çalışma zamanında bir istisna oluşur.

Parametreler

İlgili API Öğeleri

Vektörden tek bir öğe kaldırın. Bu yöntem, kopya oluşturmadan Vector öğesini değiştirir.

Parametreler

Vector öğesindeki öğelerin sırasını tersine çevirir. Bu yöntem, üzerinde çağrıldığı Vector öğesini değiştirir.

Vector öğesinden birinci öğeyi kaldırır ve o öğeyi döndürür. Kalan Vector öğeleri orijinal konumu olan i'den i-1'e taşınır.

İlgili API Öğeleri

Orijinal Vector öğesini değiştirmeden, orijinal Vector içindeki öğelerin aralığını içeren yeni bir Vector döndürür. Döndürülen Vector, startIndex öğesini ve endIndex öğesi hariç o öğeye kadar olan tüm öğeleri içerir.

Herhangi bir parametre iletmezseniz, yeni Vector örneği orijinal Vector örneğinin aynısıdır (sığ klon). Her iki parametre için de 0 değerini iletirseniz, orijinal Vector örneğiyle aynı türde yeni ve boş bir Vector örneği oluşturulur.

Parametreler

true döndüren bir öğeye ulaşılıncaya kadar Vector öğesindeki her öğede bir test işlevi çalıştırır. Bir Vector öğesindeki tüm öğelerin belirli bir sayıdan daha az değere sahip olma gibi bir ölçütü karşılayıp karşılamadığını belirlemek için bu yöntemi kullanın.

Birinci parametre (callback) bir yöntem kapanışıysa, bu yöntem için ikinci parametrenin (thisObject) null olması gerekir. Bu, söz konusu yöntemin en yaygın kullanım şeklidir.

Ancak ana zaman çizelgesindeki bir karede bir işlev oluşturduğunuzu, ancak bunun farklı bir this bağlamında çağrılmasını istediğinizi varsayın:

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Daha sonra da myVector adındaki bir Vector örneğinde some() yöntemini kullanacağınızı varsayın:

     myVector.some(myFunction, someObject);
     

myFunction, SWF dosyasının ana sınıfının bir üyesi olduğundan, farklı bir this bağlamında çalıştırılamaz. Bu kod çalıştığında Flash çalışma zamanları bir istisna atar. Şu şekilde işlevi bir değişkene atayarak bu zaman aşımı hatasını önleyebilirsiniz:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

Parametreler

function callback(item:T, index:int, vector:Vector.<T>):Boolean

İlgili API Öğeleri

Vector nesnesindeki öğeleri sıralar ve ayrıca sıralanmış bir Vector nesnesi döndürür. Bu yöntem iki değeri karşılaştıran bir işlev veya bir sıralama seçenekleri kümesi olan sortBehavior parametresine göre sıralama yapar.

Yöntem bir parametre alır. Parametre aşağıdakilerden biridir:

• Vector öğesinin temel türünün (T) iki bağımsız değişkenini alan ve bir Number öğesi döndüren bir işlev:

  function compare(x:T, y:T):Number {}

  İşlevinin mantığı, herhangi iki öğe verildiğinde (x ve y) işlevin şu üç değerden birini döndürmesidir:

  • sıralama düzeninde x y öğesinden önce görünecekse, negatif bir sayı
  • x ile y eşitse, 0
  • sıralama düzeninde x y öğesinden sonra görünecekse, pozitif bir sayı.

• aşağıdaki değerlerin bit tabanlı OR değeri olan bir sayı:
  • 1 veya Array.CASEINSENSITIVE
  • 2 veya Array.DESCENDING
  • 4 veya Array.UNIQUESORT
  • 8 veya Array.RETURNINDEXEDARRAY
  • 16 veya Array.NUMERIC

  Değer 0 ise sıralama aşağıdaki şekilde çalışır:

  • Sıralama büyük/küçük harf duyarlıdır (Z, a'dan önce gelir).
  • Sıralama artan sırada olur (a, b'den önce gelir).
  • Dizi, sıralama düzenini yansıtacak şekilde değiştirilir, aynı sıralama alanı olan birden çok öğe herhangi bir düzen dikkate alınmaksızın sıralanmış diziye art arda yerleştirilir.
  • Veri türü fark etmeksizin tüm öğeler, dizeymiş gibi sıralanır, bu nedenle "1"'in dize değeri "9"dan düşük olduğu için 100, 99'dan önce gelir.

Parametreler

İlgili API Öğeleri

Bir Vector öğesine öğe ekleyip Vector'den öğeyi kaldırır. Bu yöntem, kopya oluşturmadan Vector öğesini değiştirir.

Not: Bir Vector alt sınıfında bu yöntemi geçersiz kılmak için, şu örnekte gösterildiği gibi parametreler için ...args öğesini kullanın:

     public override function splice(...args) {
       // your statements here
     }
     

Parametreler

Belirtilen Vector içindeki öğeleri temsil eden bir dize döndürür. Vector içindeki 0 diziniyle başlayıp en yüksek dizinle biten her öğe, birleştirilmiş bir dizeye dönüştürülür ve virgüllerle birbirinden ayrılır. ActionScript 3.0 uygulamasında bu yöntem, Vector.toString() yöntemiyle aynı değeri döndürür.

İlgili API Öğeleri

Vector içindeki öğeleri temsil eden bir dize döndürür. Vector içindeki 0 diziniyle başlayıp en yüksek dizinle biten her öğe, birleştirilmiş bir dizeye dönüştürülür ve virgüllerle birbirinden ayrılır. Özel bir ayırıcı belirtmek için, Vector.join() yöntemini kullanın.

İlgili API Öğeleri

Vector öğesinin başına bir veya daha fazla öğe ekler ve Vector öğesinin yeni uzunluğunu döndürür. Vector içindeki diğer öğeler, orijinal konumu olan i'den i + yeni öğe sayısına taşınır.

Bu işlev birden çok argümanı kabul edebildiğinden, argümanların veri türü katı modda bile derleme zamanında kontrol edilmez. Ancak taban türünün örneği olmayan bir argüman iletilirse, çalışma zamanında bir istisna oluşur.

Parametreler

İlgili API Öğeleri