Vector  - AS3

Określa, czy można zmieniać właściwość length instancji Vector. Jeśli ta wartość to true, nie można zmienić właściwości length. Oznacza to, że następujące operacje nie są dozwolone w przypadku gdy parametr fixed ma wartość true:

• bezpośrednie ustawianie właściwości length
• przypisywanie wartości indeksowi length
• wywoływanie metody zmieniającej właściwość length, w tym:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (jeśli wywołanie metody splice() ma za zadanie spowodować zmianę właściwości length instancji Vector).

Zakres poprawnych indeksów dostępnych dla instancji Vector. Instancja Vector posiada indeksy do wartości length (bez tej wartości).

Każdy element instancji Vector zawsze posiada wartość będącą jest albo instancją typu bazowego, albo wartością null. Jeśli właściwość length zostanie ustawiona na wartość większą niż wartość wcześniejsza, utworzone zostaną dodatkowe elementy i zapełnione wartością domyślną stosowną dla typu bazowego (null dla typów odwołania).

Jeśli właściwość length zostanie ustawiona na wartość mniejszą niż wartość wcześniejsza, wszystkie elementy o indeksie większym lub równym nowej wartości length zostaną usunięte z instancji Vector.

Tworzy wystąpienie Vector o określonym typie bazowym.

Podczas wywołania konstruktora Vector.<T>() należy za pomocą składni parametru określić typ bazowy. Składnia parametru to sekwencja składająca się z kropki (.), lewy nawias ostry (<), nazwę klasy oraz prawy nawias ostry (>), tak jak w poniższym przykładzie:

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

Aby utworzyć instancję Vector z instancji Array lub innej instancji Vector (jak np. tej o odmiennym typie bazowym), należy użyć globalnej funkcji Vector().

Aby utworzyć wstępnie zapełnioną instancję klasy Vector, należy skorzystać z następującej składni zamiast używać parametrów podanych poniżej:

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

Do tej składni odnoszą się następujące informacje:

• Jest obsługiwana w programie Flash Professional CS5 i nowszych wersjach, Flash Builder 4 i nowszych wersjach oraz Flex 4 i nowszych wersjach.
• Końcowy przecinek jest opcjonalny.
• Puste elementy w tablicy nie są dozwolone; taka instrukcja, jak var v:Vector.<int> = new <int>[0,,2,] powoduje zgłoszenie błędu przez kompilator.
• Nie można określić domyślnej długości instancji klasy Vector. Długość jest określana na podstawie liczby elementów na liście inicjującej instancję.
• Nie można określić, czy instancja klasy Vector ma mieć stałą długość, czy nie. Należy zamiast tego skorzystać z właściwości fixed.
• Jeśli elementy przekazane jako wartości nie będą zgodne z określonym typem, może dojść do utraty danych lub wystąpienia błędów. Na przykład:

     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
     

Powiązane elementy interfejsu API

Przeprowadza konkatenację wektorów na liście parametrów z elementami w tym wektorze, tworząc nowy wektor. Wektory na liście parametrów muszą mieć ten sam typ bazowy lub podtyp co ten wektor. Jeśli nie zostaną przekazane żadne parametry, zwrócony wektor będzie stanowić duplikat (jednopoziomowy klon) oryginalnego wektora.

Parametry

Uruchamia funkcję testowa dla poszczególnych elementów instancji Vector do momentu, aż pojawi się element, dla którego określona funkcja zwróci wartość false. Tę metodę wykorzystuje się do określenia, czy wszystkie elementy instancji Vector spełniają dane kryterium, jak np. posiadanie wartości mniejszych od określonej liczby.

Wartość drugiego parametru thisObject dla tej metody musi być równa wartości null, jeśli pierwszy parametr callback stanowi zamknięcie metody. Jest to najczęstszy sposób korzystania z tej metody.

Załóżmy, że użytkownik tworzy funkcję dla klatki na głównej osi czasu programu Flash Professional i chce, aby była wywoływana w innym kontekście identyfikatora this:

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

Załóżmy, że wówczas użytkownik stosuje metodę every() dla instancji Vector o nazwie myVector:

    myVector.every(myFunction, someObject);
    

Ponieważ funkcja myFunction należy do klasy głównej pliku SWF, nie można wykonać jej w innym kontekście identyfikatora this. Uruchomienie tego kodu spowoduje wygenerowanie wyjątku w środowisku wykonawczym Flash. Aby uniknąć tego błędu wykonania, należy funkcji przypisać zmienną w następujący sposób:

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

Parametry

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

Powiązane elementy interfejsu API

Uruchamia funkcję testową dla poszczególnych elementów instancji Vector i zwraca nową instancję Vector, która zawiera wszystkie elementy, dla których dana funkcja zawraca wartość true. Jeśli dla danego elementu funkcja zwraca wartość false, nie zostaje on uwzględniony w wynikowej instancji Vector. Typ bazowy zwróconej instancji Vector jest zgodny z typem bazowym instancji Vector, dla której dana funkcja została wywołana.

Wartość drugiego parametru thisObject dla tej metody musi być równa wartości null, jeśli pierwszy parametr callback stanowi zamknięcie metody. Jest to najczęstszy sposób korzystania z tej metody.

Załóżmy, że użytkownik tworzy funkcję dla klatki na głównej osi czasu programu Flash Professional i chce, aby była wywoływana w innym kontekście identyfikatora this:

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

Załóżmy, że użytkownik uruchamia następnie metodę filter() dla instancji Vector o nazwie myVector:

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

Ponieważ funkcja myFunction należy do klasy głównej pliku SWF, nie można wykonać jej w innym kontekście identyfikatora this. Uruchomienie tego kodu spowoduje wygenerowanie wyjątku w środowisku wykonawczym Flash. Aby uniknąć tego błędu wykonania, należy funkcji przypisać zmienną w następujący sposób:

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

Parametry

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

Powiązane elementy interfejsu API

Uruchamia funkcję dla poszczególnych elementów instancji Vector.

Wartość drugiego parametru thisObject dla tej metody musi być równa wartości null, jeśli pierwszy parametr callback stanowi zamknięcie metody. Jest to najczęstszy sposób korzystania z tej metody.

Załóżmy, że użytkownik tworzy funkcję dla klatki na głównej osi czasu programu Flash Professional i chce, aby była wywoływana w innym kontekście identyfikatora this:

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

Załóżmy, że użytkownik uruchamia następnie metodę forEach() dla instancji Vector o nazwie myVector:

     myVector.forEach(myFunction, someObject);
     

Ponieważ funkcja myFunction należy do klasy głównej pliku SWF, nie można wykonać jej w innym kontekście identyfikatora this. Uruchomienie tego kodu spowoduje wygenerowanie wyjątku w środowisku wykonawczym Flash. Aby uniknąć tego błędu wykonania, należy funkcji przypisać zmienną w następujący sposób:

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

Parametry

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

Wyszukuje element instancji Vector i zwraca jego indeks. Element jest porównywany z elementami Vector za pomocą operatora ścisłej równości (===).

Parametry

Powiązane elementy interfejsu API

Wstawia pojedynczy element do obiektu klasy Vector. Ta metoda zmienia instancję Vector i nie tworzy jej kopii.

Parametry

Konwertuje elementy instancji Vector na ciągi znaków, wstawia między ciągami określone separatory, łączy ciągi oraz zwraca wynikowy ciąg znaków. Zagnieżdżona instancja Vector jest zawsze oddzielona przecinkiem (,), a nie separatorem przekazany za pomocą metody join().

Parametry

Powiązane elementy interfejsu API

Wyszukuje elementy w instancji Vector od końca od określonego indeksu i zwraca indeks zgodnego elementu. Element jest porównywany z elementami wystąpienia klasy Vector za pomocą operatora ścisłej równości (===).

Parametry

Powiązane elementy interfejsu API

Uruchamia funkcję dla poszczególnych elementów instancji Vector i zwraca nową instancję Vector zawierającą wyniki, które odpowiadają rezultatom wywołania funkcji dla poszczególnych elementów tej instancji Vector. Wynikowa instancja Vector posiada ten sam typ bazowy oraz wartość parametru length co oryginalny instancja Vector. Element o indeksie i w wynikowej instancji Vector stanowi wynik wywołania ostatniego elementu o indeksie i w oryginalnej instancji Vector.

Wartość drugiego parametru thisObject dla tej metody musi być równa wartości null, jeśli pierwszy parametr callback stanowi zamknięcie metody. Jest to najczęstszy sposób korzystania z tej metody.

Załóżmy, że użytkownik tworzy funkcję dla klatki na głównej osi czasu programu Flash Professional i chce, aby była wywoływana w innym kontekście identyfikatora this:

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

Załóżmy, że użytkownik zamierza następnie uruchomić metodę map() dla instancji Vector o nazwie myVector:

     myVector.map(myFunction, someObject);
     

Ponieważ funkcja myFunction należy do klasy głównej pliku SWF, nie można wykonać jej w innym kontekście identyfikatora this. Uruchomienie tego kodu spowoduje wygenerowanie wyjątku w środowisku wykonawczym Flash. Aby uniknąć tego błędu wykonania, należy funkcji przypisać zmienną w następujący sposób:

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

Parametry

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

Powiązane elementy interfejsu API

Usuwa i zwraca ostatni element instancji Vector. Wywołanie tej funkcji spowoduje pomniejszenie o jeden właściwości length instancji Vector.

Powiązane elementy interfejsu API

Dodaje co najmniej jeden element na koniec wystąpienia klasy Vector i zwraca jego nową długość.

Ponieważ ta funkcje może przyjmować wiele argumentów, w trakcie kompilacji, nawet w trybie dokładnym, typ danych nie jest sprawdzany. W przypadku przekazania argumenty, który nie jest instancją typu bazowego podczas wykonania wygenerowany zostanie wyjątek.

Parametry

Powiązane elementy interfejsu API

Usuwa pojedynczy element z obiektu Vector. Ta metoda zmienia obiekt Vector i nie tworzy jego kopii.

Parametry

Odwraca kolejność elementów w obiekcie Vector. Ta metoda zmienia obiekt Vector, dla którego została wywołana.

Usuwa i zwraca pierwszy element instancji Vector. Pozostałe elementy instancji Vector zostają przesunięte względem swojego oryginalnego położenia i do położenia i -1.

Powiązane elementy interfejsu API

Zwraca nowy instancji Vector zwierającą zakres elementów oryginalnej instancji Vector, nie modyfikując oryginalnej instancji Vector. Zwrócona instancja Vector zawiera element startIndex oraz wszystkie elementy aż do elementu endIndex (z jego wyłączeniem).

Jeśli nie zostaną przekazane żadne parametry, nowy obiekt Vector będzie stanowić duplikat (jednopoziomowy klon) oryginalnego obiektu Vector. Przekazanie w obu parametrach wartości 0 spowoduje utworzenie nowego, pustego obiektu Vector tego samego typu, co oryginalny obiekt Vector.

Parametry

Uruchamia funkcję testową dla poszczególnych elementów instancji Vector do momentu pojawienia się elementu, dla którego zwracana będzie wartość true. Ta metoda służy określeniu, czy dowolny element obiektu Vector spełnia kryterium, jak np. posiadanie wartości mniejszej od określonej liczby.

Wartość drugiego parametru thisObject dla tej metody musi być równa wartości null, jeśli pierwszy parametr callback stanowi zamknięcie metody. Jest to najczęstszy sposób korzystania z tej metody.

Załóżmy, że użytkownik tworzy funkcję dla klatki na głównej osi czasu i chce, aby była wywoływana w innym kontekście identyfikatora this:

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

Załóżmy, że użytkownik uruchamia następnie metodę some() dla instancji Vector o nazwie myVector:

     myVector.some(myFunction, someObject);
     

Ponieważ funkcja myFunction należy do klasy głównej pliku SWF, nie można wykonać jej w innym kontekście identyfikatora this. Uruchomienie tego kodu spowoduje wygenerowanie wyjątku w środowisku wykonawczym Flash. Aby uniknąć tego błędu wykonania, należy funkcji przypisać zmienną w następujący sposób:

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

Parametry

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

Powiązane elementy interfejsu API

Sortuje elementy w obiekcie Vector i zwraca posortowany obiekt Vector. Ta metoda sortuje zgodnie z parametrem sortBehavior, który jest funkcją porównującą dwie wartości lub zestawem opcji sortowania.

Ta metoda przyjmuje jeden parametr. Parametr jest jednym z następujących elementów:

• Może to być funkcja przyjmująca dwa argumenty typu bazowego (T) obiektu Vector i zwracająca liczbę.

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

  Logika funkcji działa tak, że w przypadku dwóch elementów x i y funkcja zwraca jedną z następujących trzech wartości:

  • liczbę ujemną, jeśli x występuje przed y w wysortowanej sekwencji
  • 0, jeśli x jest równe y
  • liczbę dodatnią, jeśli x występuje po y w wysortowanej sekwencji

• liczbę stanowiącą sumę bitową następujących wartości:
  • 1 lub Array.CASEINSENSITIVE
  • 2 lub Array.DESCENDING
  • 4 lub Array.UNIQUESORT
  • 8 lub Array.RETURNINDEXEDARRAY
  • 16 lub Array.NUMERIC

  Jeśli wartość wynosi 0, sortowanie działa w następujący sposób:

  • Wielkość liter jest w sortowaniu uwzględniania (Z poprzedza a).
  • Sortowanie jest rosnące (a poprzedza b).
  • Zmodyfikowana tablica odzwierciedla porządek sortowania; elementy złożone o identycznych polach sortowania zostały dowolnie umieszczone w sortowanej tablicy jedno po drugim.
  • Wszystkie elementy bez względu na typ danych są sortowane jak ciągi znaków, tak więc 100 poprzedza 99, ponieważ „1” stanowi wartość ciągu niższą od „9”.

Parametry

Powiązane elementy interfejsu API

Dodaje i usuwa elementy z instancji Vector. Ta metoda zmienia obiekt Vector i nie tworzy jego kopii.

Uwaga: Aby nadpisać tę metodę w podklasie Vector, należy jako parametrów użyć parametrów ...args, jak pokazano w poniższym przykładzie:

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

Parametry

Zwraca ciąg znaków reprezentujący elementy określonej instancji Vector. Każdy element instancji Vector, począwszy od indeksu 0 i skończywszy na najwyższym indeksie, jest konwertowany na połączony ciąg znaków i oddzielony przecinkami. W przypadku implementacji narzędzia ActionScript 3.0 ta metoda zwraca tę sama wartość co metoda Vector.toString().

Powiązane elementy interfejsu API

Zwraca ciąg znaków reprezentujący elementy instancji Vector. Każdy element wystąpienia klasy Vector, począwszy od indeksu 0 i skończywszy na najwyższym indeksie, jest konwertowany na połączony ciąg i oddzielany przecinkami. Aby określić niestandardowy separator, należy użyć metody Vector.join().

Powiązane elementy interfejsu API

Dodaje co najmniej jeden element na początek instancji Vector i zwraca nową długość instancji Vector. Pozostałe elementy instancji Vector są przesuwane względem swojego oryginalnego położenia i do nowego położenia o indeksie i + ilość nowych elementów.

Ponieważ ta funkcje może przyjmować wiele argumentów, w trakcie kompilacji, nawet w trybie dokładnym, typ danych nie jest sprawdzany. W przypadku przekazania argumenty, który nie jest instancją typu bazowego podczas wykonania wygenerowany zostanie wyjątek.

Parametry

Powiązane elementy interfejsu API