String  - AS3

Liczba całkowita oznaczająca liczbę znaków w podanym obiekcie String.

Ponieważ zbiór wartości dla wszystkich indeksów ciągów zaczyna się od wartości zero, indeks ostatniego znaku dowolnego ciągu x przyjmuje wartość x.length - 1.

Tworzy nowy obiekt String, którego wartością początkową jest podany ciąg znaków.

Uwaga: Ponieważ literały ciągów wymagają mniejszych nakładów niż obiekty String i z reguły są łatwiejsze w użyciu, należy korzystać z literałów ciągów zamiast klasy String, chyba że zastosowanie klasy String jest wysoce wskazane.

Zwraca znak znajdujący się w pozycji określonej przez parametr index. Dla wartości parametru index będącej liczbą spoza zakresu od 0 do string.length - 1 zwracany jest pusty ciąg.

Ta metoda jest podobna do metody String.charCodeAt() z tą różnicą, że zwróconą wartością jest znak, a nie jego reprezentacja zapisana w postaci 16-bitowego kodu.

Parametry

Powiązane elementy interfejsu API

Zwraca numeryczny kod Unicode znaku wskazywanego przez podany parametr index. Jeśli parametr index nie jest liczbą z zakresu od 0 do string.length - 1, wówczas wartość zwracana to NaN.

Ta metoda jest podobna do metody String.charAt(), z tą różnicą, że wartość zwróconą stanowi nie sam znak, lecz reprezentujący go 16-bitowy kod.

Parametry

Powiązane elementy interfejsu API

Dołącza dostarczone argumenty na końcu obiektu String i zwraca wynikowy ciąg znaków (w razie potrzeby argumenty są konwertowane na ciągi znaków). Oryginalna wartość źródłowego obiektu String nie zmienia się.

Parametry

Zwraca ciąg złożony ze znaków reprezentowanych przez parametry w postaci kodów znaków Unicode.

Parametry

Przeszukuje ciąg znaków począwszy od miejsca wskazywanego przez argument startIndex i zwraca położenie pierwszego wystąpienia znalezionego parametru val. Zbiór wartości dla tego indeksu zaczyna się od liczby 0, co oznacza, że pierwszy znak w ciągu jest określany indeksem o wartości 0, a nie 1. Jeśli parametr val nie zostanie znaleziony, wartością zwróconą przez metodę będzie liczba -1.

Parametry

Powiązane elementy interfejsu API

Przeszukuje ciąg znaków od strony prawej do lewej i zwraca indeks ostatniego wystąpienia wartości val znajdującego się przed argumentem startIndex. Zbiór wartości dla indeksu rozpoczyna się liczbą 0, co oznacza, że indeks pierwszego znaku przyjmuje wartość 0, a indeks znaku ostatniego — wartość string.length - 1. Jeśli wartość val nie zostanie znaleziona, wartością zwróconą przez metodę będzie liczba -1.

Parametry

Powiązane elementy interfejsu API

Porównuje efekt posortowania dwóch lub większej liczby ciągów znakowych i zwraca liczbowy wynik porównania. Ponieważ ta metoda ma na celu przeprowadzenie porównania w sposób lokalny, wyniki implementacji narzędzia ActionScript 3.0 nie będą różne od rezultatów porównań innych ciągów, jak np. porównania za pomocą operatorów równości (==) czy nierówności (!=). Jeśli ciągi są równoważne, zwróconą wartością jest liczba 0. Jeśli oryginalna wartość ciągu poprzedza wartość ciągu określoną parametrem other, wartością zwróconą będzie ujemna liczba całkowita, a jej wartość bezwzględna będzie stanowić reprezentację liczby znaków oddzielających te dwie wartości ciągu. Jeśli oryginalna wartość ciągu występuje po parametrze other, wartością zwrócona będzie dodatnia liczba całkowita, której wartość bezwzględna stanowi reprezentację liczby znaków oddzielających te dwie wartości ciągu.

Parametry

Określa zgodność ciągu znaków z parametrem pattern.

Parametry

Powiązane elementy interfejsu API

Jest zgodny z danym parametrem pattern w ciągu znaków i zwraca nowy ciąg, w którym pierwsza zgodność z parametrem pattern zostaje zastąpiona zawartością określoną parametrem repl. Parametr pattern może stanowić ciąg znaków lub wyrażenie regularne. Parametr repl może stanowić ciąg znaków lub funkcję; w przypadku funkcji ciąg przez nią zwrócony jest wstawiany w miejsce zgodności. Oryginalny ciąg znaków nie jest zmieniany.

Poniższy przykład ilustruje zastąpienie tylko pierwszej instancji znaków „sh”(ważna wielkość liter):

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

W poniższym przykładzie wszystkie instancje znaków „sh” (ważna wielkość liter) są zastępowane, ponieważ dla wyrażenia regularnego została ustawiona flaga g (global):

    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.

W poniższym przykładzie wszystkie instancje znaków „sh” są zastępowane, ponieważ dla wyrażenia regularnego została ustawiona flaga g (global), a wielkość znaków w przypadku zgodności nie ma znaczenia, ponieważ została ustawiona flaga i (ignoreCase):

    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.

Parametry

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"}

Powiązane elementy interfejsu API

Wyszukuje dany parametr pattern i zwraca indeks pierwszego zgodnego fragmentu ciągu. W przypadku braku zgodnego fragmentu ciągu metoda zwraca wartość -1.

Parametry

Powiązane elementy interfejsu API

Zwraca ciąg znaków zawierający znak określony przez parametr startIndex oraz wszystkie poprzedzające go znaki z wyłączeniem znaku określonego przez parametr endIndex. Oryginalny obiekt String nie zmieni się. Jeśli parametr endIndex nie został określony, wówczas koniec fragmentu ciągu będzie stanowić koniec ciągu. Jeśli znak określony za pomocą parametru startIndex jest identyczny jak znak określony za pomocą parametru endIndex lub, licząc od prawej strony, występuje przed tym znakiem, wówczas metoda zwróci pusty ciąg znaków.

Parametry

Powiązane elementy interfejsu API

Dzieli obiekt String w miejscach wskazywanych przez określony parametr delimiter, a uzyskane fragmenty ciągu są umieszczane w tablicy.

W przypadku gdy parametr delimiter stanowi wyrażenie regularne uwzględniana jest tylko pierwsza napotkana zgodność w danej pozycji w ciągu znaków, nawet jeśli w tej pozycji poprzez nawracanie można znaleźć inny niepusty, zgodny fragment ciągu. Na przykład:

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

Jeśli parametr delimiter stanowi wyrażenie regularne zawierające grupy ujęte w nawias, wówczas wyszukanie każdej zgodności dla parametru delimiter powoduje wyświetlenie rezultatów (wraz z niezdefiniowanymi) grupowania za pomocą nawiasów we wspólnej tablicy wynikowej. Na przykład

     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."]

Jeśli parametr limit zostanie określony, wówczas zwrócona tablica nie będzie zawierać więcej niż określoną liczbę elementów.

Jeśli parametr delimiter stanowi pusty ciąg znaków, puste wyrażenie regularne lub wyrażenie regularne, które odpowiada pustemu ciągowi znaków, elementem wynikowym umieszczonym w tablicy będzie każdy pojedynczy znak ciągu.

Jeśli parametr delimiter jest niezdefiniowany, w zwróconej tablicy, jako pierwszy jej element, zostanie umieszczony cały ciąg znaków.

Parametry

Powiązane elementy interfejsu API

Zwraca fragment ciągu składający się ze znaków liczonych od danego parametru startIndex oraz o długości określonej przez parametr len. Oryginalny ciąg nie zmienia się.

Parametry

Zwraca ciąg znaków zawierający znak określony przez parametr startIndex oraz wszystkie występujące po nim znaki do znaku określonego przez parametr endIndex - 1. Jeśli parametr endIndex nie został określony, użyty zostaje parametr String.length. Jeśli wartość parametru startIndex jest równa wartości parametru endIndex, metoda zwraca pusty ciąg znaków. Jeśli wartość parametru startIndex jest większa niż wartość parametru endIndex, parametry te są automatycznie zamieniane przed uruchomieniem funkcji. Oryginalny ciąg nie zmienia się.

Parametry

Zwraca kopię danego ciągu znaków, w której wszystkie znaki pisane wielką literą są zastępowane znakami pisanymi małą literą. Oryginalny ciąg nie zmienia się. Ponieważ ta metoda ma na celu przeprowadzenie konwersji w sposób lokalny, wyniki implementacji narzędzia ActionScript 3.0 nie będą różne od rezultatów zwróconych przez metodę toLowerCase().

Powiązane elementy interfejsu API

Zwraca kopię danego ciągu znaków, w której wszystkie znaki pisane małą literą są zastępowane znakami pisanymi wielką literą. Oryginalny ciąg nie zmienia się. Ponieważ ta metoda ma na celu przeprowadzenie konwersji w sposób lokalny, wyniki implementacji narzędzia ActionScript 3.0 nie będą różne od rezultatów zwróconych przez metodę toUpperCase().

Powiązane elementy interfejsu API

Zwraca kopię danego ciągu znaków, w której wszystkie znaki pisane wielką literą są zastępowane znakami pisanymi małą literą. Oryginalny ciąg nie zmienia się.

Ta metoda powoduje konwertowanie wszystkich znaków (nie tylko A-Z), dla których istnieją odpowiedniki Unicode pisane z małej litery:

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

Te odwzorowania wielkości liter są zdefiniowane w specyfikacji Unicode Character Database.

Powiązane elementy interfejsu API

Zwraca kopię danego ciągu znaków, w której wszystkie znaki pisane małą literą są zastępowane znakami pisanymi wielką literą. Oryginalny ciąg nie zmienia się.

Ta metoda powoduje konwertowanie wszystkich znaków (nie tylko a-z) dla których istnieją odpowiedniki Unicode pisane wielką literą:

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

Te odwzorowania wielkości liter są zdefiniowane w specyfikacji Unicode Character Database.

Powiązane elementy interfejsu API

Zwraca pierwotną wartość instancji obiektu String. Ta metoda ma na celu konwersję obiektu String na pierwotną wartość ciągu. Ponieważ środowisko wykonawcze Flash automatycznie wywołuje metodę valueOf() konieczność jej jawnego wywołania występuje niezmiernie rzadko.

1. Konstruktor klasy StringExample deklaruje kilka lokalnych instancji String, które są uruchamiane za pomocą rożnych ciągów znaków i nowego obiektu StringHelper.
2. Klasa StringHelper zawiera następujące metody:
   • replace(): wywołuje metody split() oraz join() klasy String w celu usunięcia fragmentu ciągu przekazanego wraz z nowym ciągiem.
   • trim(): wywołuje obydwie metody trimBack() oraz trimFront() za pomocą przekazanych ciągów i zwraca ciąg zaktualizowany.
   • trimFront(): rekurencyjnie usuwa wszystkie znaki zgodne z parametrem char, zaczynając od początku ciągu do jego końca, do momentu napotkania pierwszego znak ciągu niezgodnego z parametrem char i zwraca zaktualizowany ciąg.
   • trimBack(): rekurencyjnie usuwa wszystkie znaki zgodne z parametrem char, zaczynając od końca ciągu wstecz, do momentu na potkania ostatniego znaku w ciągu niezgodnego z parametrem char i zwraca zaktualizowany ciąg.
   • stringToCharacter(): zwraca pierwszy znak przekazanego ciągu.
3. Wówczas z wykorzystaniem zadeklarowanych zmiennych ciągu generowane są trzy ciągi za pomocą wywołanej metody replace(), która generuje ciąg drugi i metody trim(), która generuje ciąg trzeci.

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);
    }
}