Vector  - AS3

Indica si la propiedad length del vector puede modificarse. Si el valor es true, la propiedad length no se puede modificar. Esto significa que no se permiten las operaciones siguientes cuando fixed es true:

• establecer la propiedad length directamente
• asignar un valor a la propiedad length de la posición del índice
• llamar a un método que modifique la propiedad length, incluidos los siguientes:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (si la llamada al método splice() modifica la propiedad length del vector).

Rango de índices válidos disponibles en el vector. Una instancia de Vector tiene posiciones de índice hasta (pero sin incluir) el valor de length.

Cada elemento del vector siempre tiene un valor que, o bien es una instancia del tipo base o es null. Cuando la propiedad length se establece en un valor superior a su valor anterior, se crean elementos adicionales y se llena con el valor predeterminado correspondiente al tipo base (null para tipos de referencia).

Si la propiedad length se establece en un valor inferior a su valor anterior, todos los elementos de las posiciones de índice superiores o iguales al nuevo valor de length se eliminan del vector.

Crea un vector con el tipo base especificado.

Cuando llame al constructor Vector.<T>(), especifique el tipo base mediante la sintaxis de parámetros de tipos. La sintaxis del parámetro type se representa con una secuencia formada por un punto (. ), un paréntesis angular izquierdo (<), un nombre de clase y un paréntesis angular derecho (>), como se puede ver en el ejemplo:

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

Para crear una instancia de Vector a partir de un objeto Array u otro objeto Vector (uno con tipo base diferente, por ejemplo), utilice la función global Vector().

Para crear una instancia de un objeto Vector previamente llena, utilice la siguiente sintaxis en vez de utilizar los parámetros especificados a continuación:

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

La siguiente información se aplica a esta sintaxis:

• Se admite en Flash Professional CS5 y versiones posteriores, en Flash Builder 4 y versiones posteriores y en Flex 4 y versiones posteriores.
• La coma final es opcional.
• Vacía elementos del conjunto que no son compatibles; una sentencia como var v:Vector.<int> = new <int>[0,,2,] emite un error de compilador.
• No puede especificar un longitud predeterminada de la instancia de Vector. En su lugar, la longitud es la misma que el número de elementos de la lista de inicialización.
• No puede especificar si la instancia de Vector tiene una longitud fija. En su lugar, utilice la propiedad fixed.
• Puede producirse pérdida de datos o errores si los elementos que se transfieren como valores no coinciden con el tipo especificado. Por ejemplo:

     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
     

Elementos de API relacionados

Concatena los vectores especificados en la lista de parámetros con los elementos del vector y crea un vector nuevo. Los vectores de la lista de parámetros deben tener el mismo tipo base (o subtipo) que este vector. Si no se transfiere ningún valor, el devuelto con será un duplicado del conjunto original.

Parámetros

Ejecuta una función de prueba en cada elemento del vector hasta que se llega a un elemento que devuelve false para la función especificada. Este método se utiliza para determinar si todos los elementos de un vector cumplen un criterio como, por ejemplo, que tengan valores inferiores a un número determinado.

En el caso de este método, el segundo parámetro, thisObject, debe ser null si el primer parámetro, callback, es un cierre del método. Es la forma más habitual de utilizar este método.

Sin embargo, supongamos que crea una función en un fotograma de la línea de tiempo principal con Flash Professional pero quiere que se le llame en un contexto this distinto:

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

Supongamos que posteriormente utiliza el método every() en un vector llamado myVector:

    myVector.every(myFunction, someObject);
    

Como myFunction es un miembro de la clase principal del archivo SWF, no se puede ejecutar en un contexto this distinto. Los motores de ejecución de Flash emiten una excepción cuando se ejecuta este código. Puede evitar este error de tiempo de ejecución asignando la función a una variable de la siguiente forma:

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

Parámetros

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

Elementos de API relacionados

Ejecuta una función de prueba en cada elemento del vector y devuelve un nuevo vector con todos los elementos que devuelven true para la función especificada. Si un elemento devuelve false, no se incluye en el nuevo vector. El tipo base del objeto Vector devuelto coincide con el tipo base del vector en el que se llama al método.

En el caso de este método, el segundo parámetro, thisObject, debe ser null si el primer parámetro, callback, es un cierre del método. Es la forma más habitual de utilizar este método.

Sin embargo, supongamos que crea una función en un fotograma de la línea de tiempo principal con Flash Professional pero quiere que se le llame en un contexto this distinto:

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

Supongamos que posteriormente utiliza el método filter() en un vector llamado myVector:

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

Como myFunction es un miembro de la clase principal del archivo SWF, no se puede ejecutar en un contexto this distinto. Los motores de ejecución de Flash emiten una excepción cuando se ejecuta este código. Puede evitar este error de tiempo de ejecución asignando la función a una variable de la siguiente forma:

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

Parámetros

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

Elementos de API relacionados

Ejecuta una función en cada elemento del vector.

En el caso de este método, el segundo parámetro, thisObject, debe ser null si el primer parámetro, callback, es un cierre del método. Es la forma más habitual de utilizar este método.

Sin embargo, supongamos que crea una función en un fotograma de la línea de tiempo principal con Flash Professional pero quiere que se le llame en un contexto this distinto:

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

Supongamos que posteriormente utiliza el método forEach() en un vector llamado myVector:

     myVector.forEach(myFunction, someObject);
     

Como myFunction es un miembro de la clase principal del archivo SWF, no se puede ejecutar en un contexto this distinto. Los motores de ejecución de Flash emiten una excepción cuando se ejecuta este código. Puede evitar este error de tiempo de ejecución asignando la función a una variable de la siguiente forma:

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

Parámetros

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

Busca un elemento en el vector y devuelve la posición de su índice. Este elemento se compara con los elementos del vector mediante una igualdad estricta (===).

Parámetros

Elementos de API relacionados

Inserte un solo elemento en el vector. Este método modifica el vector sin realizar ninguna copia de él.

Parámetros

Convierte los elementos de un vector en cadenas, inserta el separador especificado entre los elementos, los concatena y devuelve la cadena resultante. Un vector anidado siempre va separado por una coma (,), no por el separador pasado al método join().

Parámetros

Elementos de API relacionados

Busca un elemento en el vector, retrocediendo desde la posición de índice especificada y volviendo a la posición del elemento coincidente. Este elemento se compara con los elementos del vector mediante una igualdad estricta (===).

Parámetros

Elementos de API relacionados

Ejecuta una función en cada elemento del vector y devuelve un nuevo vector con los elementos correspondientes a los resultados de llamar a la función en cada elemento del vector. El vector resultante tiene el mismo tipo base y la misma length que el vector original. El elemento en el índice i del vector resultante es el resultado de llamar al elemento en el índice i del vector original.

En el caso de este método, el segundo parámetro, thisObject, debe ser null si el primer parámetro, callback, es un cierre del método. Es la forma más habitual de utilizar este método.

Sin embargo, supongamos que crea una función en un fotograma de la línea de tiempo principal con Flash Professional pero quiere que se le llame en un contexto this distinto:

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

Supongamos que posteriormente utiliza el método map() en un vector llamado myVector:

     myVector.map(myFunction, someObject);
     

Como myFunction es un miembro de la clase principal del archivo SWF, no se puede ejecutar en un contexto this distinto. Los motores de ejecución de Flash emiten una excepción cuando se ejecuta este código. Puede evitar este error de tiempo de ejecución asignando la función a una variable de la siguiente forma:

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

Parámetros

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

Elementos de API relacionados

Elimina el último elemento del vector y devuelve dicho elemento. La propiedad length del vector se reduce en uno cuando se llama a esta función.

Elementos de API relacionados

Añade uno o varios elementos al final del vector y devuelve la nueva longitud del vector.

Como esta función puede admitir varios argumentos, el tipo de datos de los argumentos no se verifica en tiempo de compilación, ni siquiera en modo estricto. No obstante, si se transfiere un argumento que no sea una instancia del tipo base, se produce una excepción en tiempo de ejecución.

Parámetros

Elementos de API relacionados

Elimine un elemento individual del vector. Este método modifica el vector sin realizar ninguna copia de él.

Parámetros

Invierte el orden de los elementos del vector. Este método altera el vector en el que se llama.

Elimina el primer elemento del vector y devuelve dicho elemento. Los restantes elementos del vector se desplazan de su posición original, de i a i - 1.

Elementos de API relacionados

Devuelve un vector nuevo que consta de un rango de elementos del vector original sin modificar el vector original. El vector devuelto incluye el elemento startIndex y todos los elementos hasta endIndex, sin incluir éste.

Si no se transfiere ningún valor, el nuevo con será un duplicado del conjunto original. Si se transfiere un valor de 0 para ambos parámetros, se crea un nuevo Vector vacío del mismo tipo que el vector original.

Parámetros

Ejecuta una función de prueba en cada elemento del vector hasta que se llega a un elemento que devuelve true. Utilice este método para determinar si todos los elementos de un vector cumplen un criterio como, por ejemplo, que tengan valores inferiores a un número determinado.

En el caso de este método, el segundo parámetro, thisObject, debe ser null si el primer parámetro, callback, es un cierre del método. Es la forma más habitual de utilizar este método.

Sin embargo, supongamos que crea una función en un fotograma de la línea de tiempo principal pero quiere que se le llame en un contexto this distinto:

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

Supongamos que posteriormente utiliza el método some() en un vector llamado myVector:

     myVector.some(myFunction, someObject);
     

Como myFunction es un miembro de la clase principal del archivo SWF, no se puede ejecutar en un contexto this distinto. Los motores de ejecución de Flash emiten una excepción cuando se ejecuta este código. Puede evitar este error de tiempo de ejecución asignando la función a una variable de la siguiente forma:

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

Parámetros

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

Elementos de API relacionados

Ordena los elementos del objeto Vector, y también devuelve un objeto vectorial ordenado. Este método ordena por el parámetro sortBehavior, que es una función que compara dos valores o un conjunto de opciones de ordenación.

El método toma un parámetro. El parámetro es uno de los siguientes:

• una función que acepta dos argumentos del tipo base (T) del vector y devuelve un número:

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

  La lógica de la función es que, dados dos elementos x e y, la función devuelve uno de los tres valores siguientes:

  • un número negativo; si x debe aparecer antes que y en la secuencia ordenada
  • 0; si x es igual a y
  • un número positivo; si x debe aparecer después de y en la secuencia ordenada

• un número que es un OR en modo bit de los siguientes valores:
  • 1 o Array.CASEINSENSITIVE
  • 2 o Array.DESCENDING
  • 4 o Array.UNIQUESORT
  • 8 o Array.RETURNINDEXEDARRAY
  • 16 o Array.NUMERIC

  Si el valor es 0, la ordenación funciona de la siguiente forma:

  • La ordenación distingue entre mayúsculas y minúsculas (Z precede a a).
  • La ordenación es ascendente (a precede a b).
  • El conjunto se modifica para reflejar el orden de clasificación; los elementos que tengan campos de ordenación idénticos se sitúan consecutivamente en el conjunto ordenado sin seguir ningún orden específico.
  • Todos los elementos, con independencia de su tipo de datos, se ordenan como si fueran cadenas, de manera que 100 precede a 99, dado que "1" es un valor de cadena inferior a "9".

Parámetros

Elementos de API relacionados

Añade y elimina elementos del vector. Este método modifica el vector sin realizar ninguna copia de él.

Nota: para anular este método en una subclase de Vector, utilice ...args para los parámetros, como se muestra en este ejemplo:

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

Parámetros

Devuelve una cadena que representa los elementos del vector especificado. Cada elemento del vector, comenzando por el índice 0 y terminando por el índice más alto, se convierte en una cadena concatenada separada por comas. En la implementación ActionScript 3.0, este método devuelve el mismo valor que el método Vector.toString().

Elementos de API relacionados

Devuelve una cadena que representa los elementos del vector. Cada elemento del vector, comenzando por el índice 0 y terminando por el índice más alto, se convierte en una cadena concatenada separada por comas. Para especificar un separador personalizado, utilice el método Vector.join().

Elementos de API relacionados

Añade uno o varios elementos al comienzo del vector y devuelve la nueva longitud del vector. El resto de elementos del vector se mueven desde su posición original, de i a i +, el número correspondiente de elementos nuevos.

Como esta función puede admitir varios argumentos, el tipo de datos de los argumentos no se verifica en tiempo de compilación, ni siquiera en modo estricto. No obstante, si se transfiere un argumento que no sea una instancia del tipo base, se produce una excepción en tiempo de ejecución.

Parámetros

Elementos de API relacionados