String  - AS3

Belirtilen String nesnesindeki karakter sayısını belirten bir tam sayı.

Tüm dize dizinleri sıfır tabanlı olduğundan, herhangi bir x dizesinin son karakterinin dizini x.length -1 olur.

Belirtilen dize ile ilk değerini alan yeni bir String nesnesi oluşturur.

Not: Dize değişmezleri String nesnelerinden daha az ek yük kullandığından ve genellikle daha kolay kullanılabildiğinden, dize değişmezi yerine String nesnesi kullanmanız için geçerli bir nedeniniz olmadığı sürece, String sınıfı yerine dize değişmezlerini kullanmanız gerekir.

index parametresi ile belirtilen konumdaki karakteri döndürür. index, 0 ile string.length - 1 arasında bir sayı değilse, boş bir dize döndürülür.

Bu yöntem, döndürülen değerin 16 bit tam sayı karakter kodu değil de, bir karakter olması dışında String.charCodeAt() öğesine benzer.

Parametreler

İlgili API Öğeleri

Belirtilen dizindeki karakterin sayısal Unicode karakter kodunu döndürür. index, 0 ile string.length - 1 arasında bir sayı değilse, NaN döndürülür.

Bu yöntem, döndürülen değerin gerçek karakter değil de, 16 bit tam sayı karakter kodu olması dışında String.charAt() öğesine benzer.

Parametreler

İlgili API Öğeleri

Sağlanan argümanları String nesnesinin sonuna ekler, bunları gerekirse dizelere dönüştürür ve sonuç dizesini döndürür. Kaynak String nesnesinin orijinal değeri değişmeden kalır.

Parametreler

Parametrelerde Unicode karakter kodlarının temsil ettiği karakterlerden oluşan bir dize döndürür.

Parametreler

Dizeyi arar ve çağıran dizenin startIndex öğesinde veya sonrasında val parametresinin ilk görüldüğü yerin konumunu döndürür. Bu dizin sıfır temellidir, başka bir deyişle, dizedeki birinci karakterin index 1'de değil, index 0'da olduğu düşünülür. val bulunmazsa, yöntem -1 döndürür.

Parametreler

İlgili API Öğeleri

Dizeyi sağdan sola arar ve val parametresinin startIndex öğesinden önce bulunan son görüldüğü yerin dizinini döndürür. Dizin sıfır temellidir, başka bir deyişle, birinci karakter dizin 0'da ve son karakter de string.length - 1'dedir. val bulunmazsa, yöntem -1 döndürür.

Parametreler

İlgili API Öğeleri

İki veya daha fazla dizenin sıralama düzenini karşılaştırır ve karşılaştırmanın sonucunu bir tam sayı olarak döndürür. Bu yöntem, yerel ayarlara özel bir şekilde karşılaştırma yapmak üzere tasarlanmış olup ActionScript 3.0 uygulaması, eşitlik (==) veya eşitsizlik (!=) operatörleri gibi diğer dize karşılaştırmalarından farklı bir sonuç üretmez. Dizeler eşdeğerse, dönüş değeri 0 olur. Orijinal dize, other ile belirtilen dize değerinden önce gelirse, dönüş değeri negatif bir tam sayı olup bu, iki dize değerini ayıran karakterlerin sayısını temsil eden mutlak değerdir. Orijinal dize, other öğesinden sonra gelirse, dönüş değeri pozitif bir tam sayı olup bu, iki dize değerini ayıran karakterlerin sayısını temsil eden mutlak değerdir.

Parametreler

Belirtilen pattern öğesini dize ile eşler.

Parametreler

İlgili API Öğeleri

Belirtilen pattern öğesini dize ile eşleştirir ve ilk pattern eşleşmesinin repl tarafından belirtilen içerikle değiştirildiği yeni bir dize döndürür. pattern parametresi bir dize veya normal bir ifade olabilir. repl parametresi bir dize veya işlev olabilir; bir işlev olması durumunda, eşleme yerine eklenen işlev tarafından dize döndürülür. Orijinal dize değiştirilmez.

Şu örnekte, yalnızca "sh" (büyük/küçük harf duyarlı) öğesinin görüldüğü ilk öğe değiştirilir:

    var myPattern:RegExp = /sh/;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seashore.

Şu örnekte, g (global) bayrağı normal ifadede belirlendiğinden, "sh" (büyük/küçük harf duyarlı) öğesinin görüldüğü tüm öğeler değiştirilir:

    var myPattern:RegExp = /sh/g;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seaschore.

Şu örnekte, g (global) bayrağı normal ifadede belirlendiğinden "sh" öğesinin görüldüğü tüm öğeler değiştirilir ve i (ignoreCase) bayrağı belirlendiğinden, eşlemeler büyük/küçük harf duyarlı değildir:

    var myPattern:RegExp = /sh/gi;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // sche sells seaschells by the seaschore.

Parametreler

var str:String = "flip-flop";
    var pattern:RegExp = /(\w+)-(\w+)/g;
    trace(str.replace(pattern, "$2-$1")); // flop-flip

    var str1:String = "abc12 def34";
    var pattern:RegExp = /([a-z]+)([0-9]+)/;
    var str2:String = str1.replace(pattern, replFN);
    trace (str2);   // 12abc 34def
    
    function replFN():String {
      return arguments[2] + arguments[1];
    }

    {"abc12", "abc", "12", 0, "abc12 def34"}

    {"def34", "def", "34", 6, "abc123 def34"}

İlgili API Öğeleri

Belirtilen pattern öğesini arar ve ilk eşleşen alt dizenin dizinini döndürür. Eşleşen bir alt dize yoksa, yöntem -1 döndürür.

Parametreler

İlgili API Öğeleri

startIndex karakterinden ve endIndex karakteri hariç o karaktere kadar olan karakterleri içeren bir dize döndürür. Orijinal String nesnesi değiştirilmez. endIndex parametresi belirtilmezse, alt dizenin sonu dizenin sonudur. startIndex tarafından dizinlenen karakter, endIndex tarafından dizinlenen karakterle aynı veya bu karakterin sağındaysa, yöntem boş bir dize döndürür.

Parametreler

İlgili API Öğeleri

Bir String nesnesini, belirtilen delimiter parametresiyle karşılaşıldığı yerde alt dizeler dizisine böler.

delimiter parametresi normal bir ifadeyse, geri dönme işlemi belirli bir konumda boş olmayan bir alt dize bulabilse de, yalnızca dizenin bu belirli konumundaki birinci eşleme göz önünde bulundurulur. Örneğin:

     var str:String = "ab";
     var results:Array = str.split(/a*?/); // results == ["","b"]
     
     results = str.split(/a*/); // results == ["","b"].)

delimiter parametresi, gruplama parantezlerini içeren normal bir ifadeyse, delimiter her eşlendiğinde, gruplama parantezlerinin sonuçları (tanımsız sonuçlar dahil) çıktı dizisinde birleştirilir. Örneğin

     var str:String = "Thi5 is a tricky-66 example.";
     var re:RegExp = /(\d+)/;
     var results:Array = str.split(re);
         // results == ["Thi","5"," is a tricky-","66"," example."]

limit parametresi belirtilirse, belirtilen öğe sayısından daha fazlası dönüş dizisinde olmaz.

delimiter boş bir dize, boş bir normal ifade veya boş bir dizeyle eşlenebilen normal bir ifadeyse, dizedeki tek karakterlerin her birinin, dizide bir öğe olarak çıktısı alınır.

delimiter parametresi tanımsızsa, tüm dize, dönüş dizisinin birinci öğesine yerleştirilir.

Parametreler

İlgili API Öğeleri

Belirtilen startIndex öğesinde başlayıp len ile belirtilen uzunluk kadar karakterden oluşan bir alt dizeyi döndürür. Orijinal dize değiştirilmez.

Parametreler

startIndex tarafından belirtilen karakterden ve endIndex - 1'e kadar olan tüm karakterlerden oluşan bir dize döndürür. endIndex belirtilmezse, String.length kullanılır. startIndex değeri, endIndex değerine eşitse, yöntem boş bir dize getirir. startIndex değeri, endIndex değerinden büyükse, işlev yürütülmeden önce parametreler otomatik olarak değiştirilir. Orijinal dize değiştirilmez.

Parametreler

Bu dizenin tüm büyük harfli karakterleri küçük harfe çevrilmiş bir kopyasını döndürür. Orijinal dize değiştirilmez. Bu yöntem, dönüştürmeyi yerel ayarlara özel bir şekilde işlemek üzere tasarlanmışken, ActionScript 3.0 uygulaması, toLowerCase() yönteminden farklı bir sonuç üretmez.

İlgili API Öğeleri

Bu dizenin tüm küçük harfleri büyük harfe çevrilmiş bir kopyasını döndürür. Orijinal dize değiştirilmez. Bu yöntem, dönüştürmeyi yerel ayarlara özel bir şekilde işlemek üzere tasarlanmışken, ActionScript 3.0 uygulaması, toUpperCase() yönteminden farklı bir sonuç üretmez.

İlgili API Öğeleri

Bu dizenin tüm büyük harfli karakterleri küçük harfe çevrilmiş bir kopyasını döndürür. Orijinal dize değiştirilmez.

Bu yöntem, küçük harfli Unicode eşdeğerleri olan tüm karakterleri (yalnızca A-Z değil) dönüştürür:

     var str:String = " JOSÉ BARÇA";
     trace(str.toLowerCase()); // josé barça

Bu büyük harf/küçük harf eşlemeleri adresindeki Unicode Character Database (Unicode Karakter Veritabanı) bölümünde tanımlanır.

İlgili API Öğeleri

Bu dizenin tüm küçük harfleri büyük harfe çevrilmiş bir kopyasını döndürür. Orijinal dize değiştirilmez.

Bu yöntem, küçük harfli Unicode eşdeğerleri olan tüm karakterleri (yalnızca a-z değil) dönüştürür:

     var str:String = "José Barça";
     trace(str.toUpperCase()); // JOSÉ BARÇA

Bu büyük harf/küçük harf eşlemeleri adresindeki Unicode Character Database (Unicode Karakter Veritabanı) bölümünde tanımlanır.

İlgili API Öğeleri

Bir String örneğinin temel değerini döndürür. Bu yöntem, bir String nesnesini temel bir dize değerine dönüştürmek üzere tasarlanmıştır. Flash çalışma zamanları gerektiğinde otomatik olarak valueOf() öğesini çağırdığından, bu yöntemi nadiren açıkça çağırmanız gerekir.

1. StringExample sınıfının yapıcısı çeşitli dizelerle ve bir yeni StringHelper nesnesiyle başlatılan bazı yerel String örnekleri bildirir.
2. StringHelper sınıfında şu yöntemler vardır:
   • replace(): yeni bir dizeyle birlikte iletilen dizedeki alt dizeyi kaldırmak için String sınıfının split() ve join() yöntemlerini çağırır.
   • trim(): iletilen dizeleri kullanarak trimBack() ve trimFront() yöntemlerini çağırır ve güncellenen dizeyi döndürür.
   • trimFront(): char parametresiyle eşleşen karakterleri yinelemeli olarak kaldırır; bunu yaparken dizenin başından başlar ve sonuna doğru ilerleyerek dizenin ilk karakteri char parametresiyle eşleşmeyene kadar devam eder ve güncellenen dizeyi döndürür.
   • trimBack(): char parametresiyle eşleşen karakterleri yinelemeli olarak kaldırır; bunu yaparken dizenin sonundan başlar ve başına doğru geri giderek dizenin son karakteri char parametresiyle eşleşmeyene kadar devam eder ve güncellenen dizeyi döndürür.
   • stringToCharacter(): iletilen dizinin ilk karakterini döndürür.
3. Daha sonra, ikinci dizeyi üretmek için kullanılan replace() yöntemi çağrısı ve üçüncü dizeyi üretmek için kullanılan trim() çağrısı ile bildirilen dize değişkenleri kullanılarak üç dize üretilir.

package {
    import flash.display.Sprite;

    public class StringExample extends Sprite {
        public function StringExample() {
            var companyStr:String = new String("     Company X");
            var productStr:String = "Product Z Basic     ";
            var emptyStr:String = " ";
            var strHelper:StringHelper = new StringHelper();

            var companyProductStr:String = companyStr + emptyStr + productStr;
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Basic     '

            companyProductStr = strHelper.replace(companyProductStr, "Basic", "Professional");
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Professional     '

            companyProductStr = strHelper.trim(companyProductStr, emptyStr);
            trace("'" + companyProductStr + "'");    // 'Company X Product Z Professional'
        }
    }
}

class StringHelper {
    public function StringHelper() {
    }

    public function replace(str:String, oldSubStr:String, newSubStr:String):String {
        return str.split(oldSubStr).join(newSubStr);
    }

    public function trim(str:String, char:String):String {
        return trimBack(trimFront(str, char), char);
    }

    public function trimFront(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(0) == char) {
            str = trimFront(str.substring(1), char);
        }
        return str;
    }

    public function trimBack(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(str.length - 1) == char) {
            str = trimBack(str.substring(0, str.length - 1), char);
        }
        return str;
    }

    public function stringToCharacter(str:String):String {
        if (str.length == 1) {
            return str;
        }
        return str.slice(0, 1);
    }
}