Üst Düzey 

Negatif Infinity öğesini temsil eden özel bir değer. Bu sabitin değeri, Number.NEGATIVE_INFINITY ile aynıdır.

İlgili API Öğeleri

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Pozitif Infinity öğesini temsil eden özel bir değer. Bu sabitin değeri, Number.POSITIVE_INFINITY ile aynıdır.

İlgili API Öğeleri

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

Number veri türünün, "sayı olmayan" (NaN) bir değeri temsil eden özel bir üyesi. Matematiksel bir ifade, sayı olarak ifade edilemeyen bir değer verirse, sonuç NaN olur. Şu liste, NaN sonucunu veren yaygın ifadeleri açıklar.

• Yalnızca bölen de 0 olursa, 0'a bölmenin sonucu NaN olur. Bölen 0'dan büyükse, 0'a bölme Infinity sonucunu verir. Bölen 0'dan küçükse, 0'a bölme -Infinity verir;
• Negatif bir sayının kare kökü;
• Bir sayının geçerli 0 - 1 aralığı dışındaki arksinüsü;
• Infinity değerinden çıkarılan Infinity;
• Infinity veya -Infinity değerine bölünen Infinity ya da -Infinity;
• 0 ile çarpılan Infinity veya -Infinity;

NaN değeri, int veya uint veri türlerinin bir üyesi değildir.

NaN değerinin NaN dahil başka bir değere eşit olduğu düşünülmez, bu da bir ifadenin NaN olup olmadığını test etmek için eşitlik operatörünün kullanılmasını imkansızlaştırır. Bir sayının NaN işlevi olup olmadığını belirlemek için isNaN() öğesini kullanın.

İlgili API Öğeleri

İlk değeri atanmamış türsüz değişkenler veya ilk değeri verilmemiş dinamik nesne özellikleri için geçerli özel bir değer. ActionScript 3.0'da yalnızca türsüz değişkenler undefined değerini tutabilirken bu, ActionScript 1.0 ve ActionScript 2.0'da doğru değildir. Örneğin şu değişkenlerin ikisi de türsüz ve başlatılmamış olduğundan undefined olur:

• var foo;
• var bar:*;

undefined değeri, dinamik nesnelerin başlatılmamış veya tanımsız özellikleri için de geçerlidir. Örneğin, bir nesne Object sınıfı örneğiyse, dinamik olarak eklenen tüm özelliklerin değeri, o özelliğe bir değer atanıncaya kadar undefined olur.

undefined çeşitli işlevlerle kullanıldıkça sonuçlar değişlik gösterebilir:

• String(undefined) öğesinin döndürdüğü değer "undefined" olur (undefined bir dizeye dönüştürülür).
• Number(undefined) öğesinin döndürdüğü değer NaN olur.
• int(undefined) ve uint(undefined) öğesinin döndürdüğü değer 0 olur.
• Object(undefined) öğesinin döndürdüğü değer yeni bir Object örneğidir.
• undefined değeri türlü bir değişkene atandığında, değer, veri türünün varsayılan değerine dönüştürülür.

undefined ile null öğelerini birbiriyle karıştırmayın. null ve undefined öğeleri eşitlik (==) operatörüyle karşılaştırıldığında, eşit olurlar. Ancak null ve undefined öğeleri katı eşitlik (===) operatörüyle karşılaştırıldığında, eşit olmazlar.

İlgili API Öğeleri

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

Yeni bir dizi oluşturur. Dizi, sıfır veya daha fazla bir uzunluk değerine sahip olabilir ya da belirtilen tek bir nesne tarafından doldurulan bir dizi olabilir.

• Herhangi bir argüman içermeyen Array() çağrıldığında boş bir dizi döndürülür.
• Tek bir tam sayı argümanı içeren Array() çağrıldığında, belirtilen uzunlukta olan ancak öğeleri tanımlanmamış değerler içeren bir dizi döndürülür.
• Belirtilmiş bir nesneyle Array() nesnesini çağırmak belirtilen nesnenin bir öğesine sahip bir dizi döndürür.

Not: Array() işlevini yeni bir dizi oluşturmak için kullanırsanız ve diziyi doldurmak için birkaç değeri parametre olarak iletirseniz derleyici hatasıyla karşılaşırsınız. Array() işlevi yalnızca bir parametreye izin verir. Bunun yerine birkaç değerden oluşan dizi oluşturmak ve doldurmak için Array sınıfı oluşturucusunu kullanın.

Array() işlevi nesne türünü bir diziye atamaz. Açık tür dönüştürme için as operatörünü veya argüman temel bir değer olmadığında tür atamasını kullanın. Daha fazla bilgi için bu girişin Örnek bölümüne bakın. Bir nesneyi parametre olarak Array() işlevine iletirseniz nesneyi öğe olarak içeren yeni bir dize oluşturulur.

Parametreler

İlgili API Öğeleri

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

expression parametresini bir Boolean değerine dönüştürür ve değeri döndürür.

Dönüş değeri, şu tabloda açıklandığı gibi argümanın veri türüne ve değerine bağlıdır:

Önceki ActionScript sürümlerinden farklı olarak, Boolean() işlevi, Boolean sınıfı yapıcısıyla aynı sonuçları döndürür.

Parametreler

Kodlanmış bir URI'nin kodunu çözerek dizeye çevirir. Önceden encodeURI işleviyle kodlanmış tüm karakterlerin kodlanmamış temsillerine geri yüklendiği bir dize.

Şu tablo, decodeURI işleviyle kodu çözülüp karakterlere çevrilmemiş çıkarma sıraları kümesini gösterir. Bu tablodaki çıkarma sıralarının kodunu çözmek için decodeURIComponent() öğesini kullanın.

Parametreler

İlgili API Öğeleri

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Kodlanmış bir URI bileşeninin kodunu çözerek dizeye çevirir. Önceden encodeURIComponent işleviyle çıkarılmış tüm karakterlerin kodlanmamış temsillerine geri yüklendiği bir dize.

Bu işlev, yalnızca URI bileşeni adı verilen bir URI dizesi bölümüyle kullanılmak üzere tasarlanmasıyla decodeURI() işlevinden ayrılır. URI bileşeni, bileşen ayırıcıları adındaki özel karakterler (: / ; ve ? ). URI bileşeninin yaygın örnekleri arasında, "http" ve "www.adobe.com" yer alır.

Bu işlev ile decodeURI() arasındaki başka bir önemli fark da, bu işlev bir URI bileşenini işlediğini varsaydığından, bu işlevin, özel ayırıcı karakterleri (; / ? : @ & = + $ , #) temsil eden çıkarma sıralarını, kodu çözülmesi gereken normal bir metin olarak değerlendirmesidir.

Parametreler

İlgili API Öğeleri

Bir dizeyi geçerli bir URI (Tekdüzen Kaynak Tanımlayıcı) olarak kodlar. Bir karakter küçük bir temel karakter grubuna ait olmadığı sürece, tam bir URI'yi tüm karakterlerin UTF-8 çıkarma sırası olarak kodlandığı bir dizeye dönüştürür.

Şu tablo, encodeURI işleviyle UTF-8 çıkarma sırasına dönüştürülmemiş tam temel karakter kümesini gösterir.

Parametreler

İlgili API Öğeleri

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

Bir dizeyi geçerli bir URI bileşeni olarak kodlar. Bir karakter çok küçük bir temel karakter grubuna ait olmadığı sürece, URI'nin bir alt dizesini tüm karakterlerin UTF-8 çıkarma sırası olarak kodlandığı bir dizeye dönüştürür.

encodeURIComponent() işlevi, yalnızca URI bileşeni adı verilen bir URI dizesi bölümüyle kullanılmak üzere tasarlanmasıyla encodeURI() işlevinden ayrılır. URI bileşeni, bileşen ayırıcıları adındaki özel karakterler (: / ; ve ? ). URI bileşeninin yaygın örnekleri arasında, "http" ve "www.adobe.com" yer alır.

Bu işlev ile encodeURI() arasındaki başka bir önemli fark da, bu işlev bir URI bileşenini işlediğini varsaydığından, bu işlevin, özel ayırıcı karakterleri (; / ? : @ & = + $ , #) kodlanması gereken normal bir metin olarak değerlendirmesidir.

Şu tablo, encodeURIComponent işleviyle UTF-8 çıkarma sıralarına dönüştürülmeyen tüm karakterleri gösterir.

Parametreler

İlgili API Öğeleri

Parametreyi bir dizeye dönüştürür ve URL kodlu biçimde kodlar; burada alfasayısal olmayan karakterlerin çoğunun yerini % onaltılık sıralar alır. Yüzde sembolü (%), URL kodu bir dizede kullanıldığında, çıkarma karakterlerini tanıtmak için kullanılır ve modulo operatörüne (%) eşdeğer değildir.

Şu tablo, escape() işleviyle çıkarma sıralarına dönüştürülmeyen tüm karakterleri gösterir.

Not: Özel ayırıcı karakterlerini (@ + /) şifrelemek için normal metin olarak işlemek üzere escape() işlevi yerine encodeURIComponent() işlevini kullanın.

Parametreler

İlgili API Öğeleri

Belirli bir sayısal bir değeri bir tam sayı değerine dönüştürür. Ondalık noktadaki ondalık değerler kesilir.

Parametreler

İlgili API Öğeleri

Değer sonlu bir sayıysa true değerini, Infinity veya -Infinity ise false değerini döndürür. Infinity veya -Infinity bulunması, 0'a bölme gibi bir matematiksel hata durumunu gösterir.

Parametreler

Değer NaN(sayı değil) ise true değerini döndürür. isNaN() işlevi, matematiksel ifadenin bir sayı şeklinde başarıyla değerlendirilip değerlendirilmeyeceğini kontrol etmede kullanışlıdır. isNaN() öğesinin en yaygın kullanımı, parseInt()ve parseFloat() işlevlerinden döndürülen değerin kontrol edilmesidir. NaN değeri, “Sayı olmayan“ bir değeri temsil eden Number veri türünün özel bir üyesidir.

Not: NaN değeri, int veya uint veri türlerinin bir üyesi değildir.

Aşağıdaki tablo, çeşitli girdi türleri ve değerlerinde isNaN() dönüş değerini açıklar. (Derleyici uyarılarınız Katı Mod'a ayarlanmışsa, aşağıdaki işlemlerden bazıları derleyici uyarıları gösterebilir.)

Parametreler

Belirtilen dizenin bir XML öğesi veya niteliği için geçerli bir ad olup olmadığını belirler.

Parametreler

Belirli bir değeri bir Number değerine çevirir. Şu tablo, çeşitli girdi türlerinin sonucunu gösterir:

Parametreler

ActionScript 3.0'daki her değer bir nesnedir, başka bir deyişle, bir değer üzerinde Object() öğesinin çağrılması o değeri döndürür.

Parametreler

Bir dizeyi kayan nokta sayısına dönüştürür. İşlev sayıları okur veya ayrıştırır ve ilk sayının bölümü olmayan bir karaktere ulaşıncaya kadar sayıları bir dizede döndürür. Dize ayrıştırılabilir bir sayıyla başlamıyorsa, parseFloat() NaN değerini döndürür. İzleyen sayısal olmayan karakterler gibi, geçerli tam sayılardan önce gelen beyaz boşluk da yok sayılır.

Parametreler

Bir dizeyi bir tam sayıya çevirir. Parametrelerdeki belirtilen dize bir sayıya dönüştürülemezse, işlev NaN değerini döndürür. 0x ile başlayan dizeler, onaltılık sayılar olarak yorumlanır. Önceki ActionScript sürümlerinde olduğu gibi, 0 ile başlayan tam sayılar sekizlik sayılar olarak yorumlanmaz. Sekizlik sayılar için bir 8 radix'i belirtmeniz gerekir. İzleyen sayısal olmayan karakterler gibi, geçerli tam sayılardan önce gelen beyaz boşluk ve sıfırlar da yok sayılır.

Parametreler

Belirtilen parametrenin dize olarak temsil edilen halini döndürür.

Şu tablo, çeşitli girdi türlerinin sonucunu gösterir:

Parametreler

Hata ayıklama sırasında ifadeleri gösterir veya günlük dosyalarına yazar. Tek bir izleme ifadesi birden çok argümanı destekleyebilir. İzleme ifadesindeki herhangi bir argüman, String dışında bir veri türü içeriyorsa, izleme işlevi o veri türü ile ilişkili toString() yöntemini çağırır. Örneğin, argüman bir Boolean değeriyse, izleme işlevi Boolean.toString() çağırır ve dönüş değerini görüntüler.

Parametreler

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

Belirli bir sayısal bir değeri bir işaretsiz tam sayı değerine çevirir. Ondalık noktadaki ondalık değerler kesilir.

Şu tablo, çeşitli girdi türleri ve değerlerinde uint() dönüş değerini açıklar.

Parametreler

İlgili API Öğeleri

str parametresini bir dize olarak değerlendirir, URL kodlu biçimdeki dizenin kodunu çözer (tüm onaltılık sıraları ASCII karakterlerine dönüştürerek) ve dizeyi döndürür.

Parametreler

Öğeleri, belirtilen veri türünün örnekleri olan yeni bir Vector örneği oluşturur. Bu işlevi çağırırken, bir type parametresini kullanarak sonuç Vector öğelerinin veri türünü (Vector öğesinin taban türü) belirtirsiniz. Bu işlev, bir Vector örneği bildirilirken veya new Vector.<T>() yapıcısı çağrılırken kullanılan sözdiziminin aynısını kullanır.

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

Sonuç Vector, sourceArray argümanının öğelerindeki değerlerle doldurulur. sourceArray argümanı zaten bir Vector ise.<T> örneği; burada T taban türü, yani Vector öğesini döndüren işlevdir. Aksi takdirde sonuç Vector öğesi, sourceArray Array veya Vector örneğinin öğeleriyle doldurulur.

Her durumda da, sourceArray argümanının tüm öğelerinin veri türü, işlev çağrısında belirtilen T taban türüyle eşleşmelidir.

sourceArray argümanı 0 length değerine sahipse, işlev boş bir Vector döndürür.

Bir Vector sourceArray argümanı olarak iletilirse ve taban türü T değilse veya bir Array iletilirse ve öğeleri T veri türünün tüm örnekleri değilse, değerleri taban türüne dönüştürmek için bir deneme yapılır. Değerler otomatik olarak dönüştürülebilirse, sonuç Vector öğesi dönüştürülen değerleri içerir. Herhangi bir dönüştürme yapılmazsa, hata oluşmaz.

Aynı şekilde, sourceArray argümanındaki bir öğe, T taban türünün alt sınıfının bir örneğiyse, çağrı başarılı olur ve öğe, sonuçta ortaya çıkan Vector öğesine eklenir. sourceArray argümanı, taban sınıfı T alt sınıfı olan bir Vector olsa da, bu işe yarar. Aslında, T taban türüne sahip bir Vector öğesini, T üst sınıfı olan bir taban sınıfına sahip Vector öğesine dönüştürmenin tek yolu budur.

Örneğin şu kod, bir Vector atamaya çalıştığı için katı modda bir derleme hatası; çalışma zamanında ise bir TypeError hatası verir.Vector öğesine <Sprite>.<DisplayObject> değişkeni (Sprite, DisplayObject öğesinin bir alt sınıfıdır):

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

Kodun şu alternatif sürümü, Vector örneğinin öğelerini başarıyla kopyalar.Vector öğesine <Sprite> örneği.<DisplayObject> örneği:

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

Parametreler

İlgili API Öğeleri

Bir nesneyi bir XML nesnesine dönüştürür.

Şu tablo, çeşitli girdi türlerinin dönüş değerlerini açıklar.

Parametreler

İlgili API Öğeleri

Bir nesneyi bir XMLList nesnesine dönüştürür.

Şu tablo, çeşitli girdi türlerinin dönüş değerlerini açıklar.

Parametreler

İlgili API Öğeleri