Paquete | Nivel superior |
Clase | public dynamic class Vector |
Herencia | Vector Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Al igual que ocurre con un objeto Array, puede utilizar el operador de acceso a conjunto ([]
) para establecer o recuperar el valor de un elemento del objeto Vector. Existen también varios métodos del objeto Vector que proporcionan mecanismos para establecer y recuperar valores de los elementos. Algunos de ellos son push()
, pop()
, shift()
o unshift()
. Las propiedades y los métodos de un objeto Vector son similares (la mayoría de las veces, idénticos) a las propiedades y métodos de un objeto Array. En la mayoría de los casos en los que utilizaría un objeto Array con todos sus elementos del mismo tipo de datos, es preferible usar una instancia del objeto Vector. Sin embargo, las instancias de Vector son conjuntos densos, lo que significa que debe tener un valor (o null
) en cada índice. Las instancias de Array no tienen esta misma restricción.
El tipo base del objeto se especifica mediante sintaxis de parámetros de tipo postfix. 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:
En la primera línea del ejemplo, la variable v
se declara como una instancia de un objeto Vector.<String>. Dicho de otro modo, representa un vector (un conjunto) que sólo puede contener instancias de String y desde el que únicamente se pueden recuperar instancias de String. La segunda línea construye una instancia del mismo tipo de vector (esto es, un vector cuyos elementos son todos objetos String) y la asigna a v
.
var v:Vector.<String>; v = new Vector.<String>();
Una variable declarada con el tipo de datos Vector.El tipo de datos <T> sólo puede almacenar una instancia de Vector construida con el mismo tipo base T
. Por ejemplo, un vector construido mediante una llamada a new Vector.<String>()
no se puede asignar a una variable que se haya declarado con el tipo de datos Vector.<int>. Los tipos base deben coincidir exactamente. Por ejemplo, el siguiente código no se puede compilar, ya que el tipo base del objeto no es el mismo que el tipo base declarado con la variable (aunque Sprite es una subclase de DisplayObject):
// This code doesn't compile even though Sprite is a DisplayObject subclass var v:Vector.<DisplayObject> = new Vector.<Sprite>();
Para convertir un objeto Vector con tipo base T
en un objeto Vector de una superclase de T
, utilice la función global Vector()
.
Además de la restricción del tipo de datos, la clase Vector tiene otras limitaciones que la distinguen de la clase Array:
- Una vector es un conjunto denso. Al contrario de lo que ocurre con un conjunto, que puede tener valores en los índices 0 y 7 incluso si no hay ningún valor en las posiciones 1-6, un vector debe tener un valor (o
null
) en cada índice. - Opcionalmente, un vector puede tener longitud fija, es decir, el número de elementos que contiene es invariable.
- El acceso a los elementos de un vector está definido por sus límites. Nunca se puede leer un valor de un índice superior a la (
longitud - 1
) del elemento final. Nunca se puede establecer un valor con un índice superior al índice final actual (dicho de otro modo, sólo se puede establecer un valor en un índice existente o en una[longitud]
de índice).
La consecuencia de estas restricciones hace que utilizar un vector presente tres ventajas frente a una instancia de Array cuyos elementos sean todos instancias de una sola clase:
- Rendimiento: el acceso y la iteración en los elementos de un conjunto son mucho más rápidos si se utiliza una instancia de Vector y no una de Array.
- Seguridad de tipos: en modo estricto, el compilador puede identificar errores de tipos de datos. Algunos ejemplos de errores de tipo de datos incluyen la asignación de un valor del tipo de datos incorrecto a un vector, o esperar un tipo de datos incorrecto al leer un valor en un vector. Tenga en cuenta, no obstante, que cuando se utiliza el método
push()
o el métodounshift()
para añadir valores a un vector, los tipos de datos de los argumentos no se comprueban en tiempo de compilación. En su lugar, se comprueban en tiempo de ejecución. - Fiabilidad: la comprobación del rango en tiempo de ejecución (o la comprobación de longitud fija) aumenta significativamente la fiabilidad en los conjuntos.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
fixed : Boolean
Indica si la propiedad length del vector puede modificarse. | Vector | ||
length : uint
Rango de índices válidos disponibles en el vector. | Vector |
Método | Definido por | ||
---|---|---|---|
Crea un vector con el tipo base especificado. | Vector | ||
Concatena los vectores especificados en la lista de parámetros con los elementos del vector y crea un vector nuevo. | Vector | ||
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. | Vector | ||
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. | Vector | ||
Ejecuta una función en cada elemento del vector. | Vector | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Busca un elemento en el vector y devuelve la posición de su índice. | Vector | ||
Inserte un solo elemento en el vector. | Vector | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Convierte los elementos de un vector en cadenas, inserta el separador especificado entre los elementos, los concatena y devuelve la cadena resultante. | Vector | ||
Busca un elemento en el vector, retrocediendo desde la posición de índice especificada y volviendo a la posición del elemento coincidente. | Vector | ||
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. | Vector | ||
pop():T
Elimina el último elemento del vector y devuelve dicho elemento. | Vector | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Añade uno o varios elementos al final del vector y devuelve la nueva longitud del vector. | Vector | ||
Elimine un elemento individual del vector. | Vector | ||
Invierte el orden de los elementos del vector. | Vector | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
shift():T
Elimina el primer elemento del vector y devuelve dicho elemento. | Vector | ||
Devuelve un vector nuevo que consta de un rango de elementos del vector original sin modificar el vector original. | Vector | ||
Ejecuta una función de prueba en cada elemento del vector hasta que se llega a un elemento que devuelve true. | Vector | ||
Ordena los elementos del objeto Vector, y también devuelve un objeto vectorial ordenado. | Vector | ||
Añade y elimina elementos del vector. | Vector | ||
Devuelve una cadena que representa los elementos del vector especificado. | Vector | ||
Devuelve una cadena que representa los elementos del vector. | Vector | ||
Añade uno o varios elementos al comienzo del vector y devuelve la nueva longitud del vector. | Vector | ||
Devuelve el valor simple del objeto especificado. | Object |
fixed | propiedad |
fixed:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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étodosplice()
modifica la propiedadlength
del vector).
Implementación
public function get fixed():Boolean
public function set fixed(value:Boolean):void
length | propiedad |
length:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
Implementación
public function get length():uint
public function set length(value:uint):void
Emite
RangeError — Si cambia esta propiedad cuando fixed es true .
| |
RangeError — Si esta propiedad se establece en un valor superior al índice máximo permisible (232).
|
Vector | () | Información sobre |
public function Vector(length:uint = 0, fixed:Boolean = false)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
length:uint (default = 0 ) — La longitud inicial (número de elementos) del vector. Si este parámetro es mayor que cero, se crea el número especificado de elementos del vector y se llena con el valor predeterminado correspondiente al tipo base (null para tipos de referencia).
| |
fixed:Boolean (default = false ) — Indica si la longitud del vector es fija (true ) o si se puede modificar (false ). Este valor también se puede establecer con la propiedad fixed .
|
Elementos de API relacionados
concat | () | método |
AS3 function concat(... args):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
... args — Cero o más vectores de tipo base (o subtipo) de este vector.
|
Vector.<T> — Un vector con el mismo tipo base que este vector que contiene los elementos del objeto Vector seguido de elementos de los vectores de la lista de parámetros.
|
Emite
TypeError — Si algún argumento no es un vector de tipo base o no se puede convertir en un vector de tipo base.
|
every | () | método |
AS3 function every(callback:Function, thisObject:Object = null):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
callback:Function — La función que se va a ejecutar en cada elemento del vector. Esta función se invoca con tres argumentos: el elemento activo del vector, el índice del elemento y el objeto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean { // your code here } La función callback debe devolver un valor Boolean. | |
thisObject:Object (default = null ) — El objeto al que hace referencia el identificador this en la función callback cuando se llama a la función.
|
Boolean — Se devuelve un booleano true si la función especificada devuelve true cuando se llama a todos los elementos del vector; en caso contrario, false .
|
Elementos de API relacionados
filter | () | método |
AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
callback:Function — La función que se va a ejecutar en cada elemento del vector. Esta función se invoca con tres argumentos: el elemento activo del vector, el índice del elemento y el objeto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean; | |
thisObject:Object (default = null ) — El objeto al que hace referencia el identificador this en la función callback cuando se llama a la función.
|
Vector.<T> — Un nuevo objeto Vector que contiene todos los elementos del objeto Vector original para el que la función callback devolvió true .
|
Elementos de API relacionados
forEach | () | método |
AS3 function forEach(callback:Function, thisObject:Object = null):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
callback:Function — La función que se va a ejecutar en cada elemento del vector. Esta función se invoca con tres argumentos: el elemento activo del vector, el índice del elemento y el objeto Vector:
function callback(item:T, index:int, vector:Vector.<T>):void; Se descarta cualquier valor devuelto desde la llamada a la función. | |
thisObject:Object (default = null ) — El objeto al que hace referencia el identificador this en la función callback cuando se llama a la función.
|
indexOf | () | método |
AS3 function indexOf(searchElement:T, fromIndex:int = 0):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
searchElement:T — El elemento que se va a buscar en el vector.
| |
fromIndex:int (default = 0 ) — La ubicación del vector en la que debe comenzar la búsqueda del elemento. Si este parámetro es negativo, se trata como length + fromIndex . Esto significa que la búsqueda se inicia en elementos -fromIndex desde el final y busca desde dicha posición hasta el final del vector.
|
int — La posición de índice basada en cero del elemento en el vector. Si no se encuentra el argumento searchElement , el valor devuelto es -1.
|
Elementos de API relacionados
insertAt | () | método |
AS3 function insertAt(index:int, element:T):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 19, AIR 19 |
Inserte un solo elemento en el vector. Este método modifica el vector sin realizar ninguna copia de él.
Parámetros
index:int — Un entero que especifica la posición en el vector en la que se va a insertar el elemento. Puede utilizar un entero negativo para especificar una posición relativa al final del vector (por ejemplo, -1 es el último elemento del vector).
| |
element:T |
Emite
RangeError — Si se llama a este método cuando fixed es true .
|
join | () | método |
AS3 function join(sep:String = ","):String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
sep:String (default = ", ") — Un carácter o una cadena que separa los elementos del vector en la cadena devuelta. Si omite este parámetro, se utilizará una coma como separador predeterminado.
|
String — Una cadena formada por los elementos de un vector convertidos en cadenas y separados por la cadena especificada.
|
Elementos de API relacionados
lastIndexOf | () | método |
AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
searchElement:T — El elemento que se va a buscar en el vector.
| |
fromIndex:int (default = 0x7fffffff ) — La ubicación del vector en la que debe comenzar la búsqueda del elemento. El valor predeterminado es el valor de índice máximo permisible. Esto significa que la búsqueda se inicia en el último elemento del vector.
Si este parámetro es negativo, se trata como |
int — La posición de índice basada en cero del elemento en el vector. Si no se encuentra el argumento searchElement , el valor devuelto es -1.
|
Elementos de API relacionados
map | () | método |
AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
callback:Function — La función que se va a ejecutar en cada elemento del vector. Esta función se invoca con tres argumentos: el elemento activo del vector, el índice del elemento y el objeto Vector:
function callback(item:T, index:int, vector:Vector.<T>):T; | |
thisObject:Object (default = null ) — El objeto al que hace referencia el identificador this en la función callback cuando se llama a la función.
|
Vector.<T> — Un nuevo vector que contiene 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 original.
|
Elementos de API relacionados
pop | () | método |
AS3 function pop():T
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
T — El valor del último elemento del vector especificado.
|
Emite
RangeError — Si se llama a este método cuando fixed es true .
|
Elementos de API relacionados
push | () | método |
AS3 function push(... args):uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
... args — Uno o más valores que se añadirán al vector.
|
uint — La longitud del vector una vez añadidos los nuevos elementos.
|
Emite
TypeError — Si algún argumento no es una instancia del tipo base T del vector.
| |
RangeError — Si se llama a este método cuando fixed es true .
|
Elementos de API relacionados
removeAt | () | método |
AS3 function removeAt(index:int):T
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 19, AIR 19 |
Elimine un elemento individual del vector. Este método modifica el vector sin realizar ninguna copia de él.
Parámetros
index:int — Un entero que especifica el índice del elemento del vector que se debe eliminar. Puede utilizar un entero negativo para especificar una posición relativa al final del vector (por ejemplo, -1 es el último elemento del vector).
|
T — El elemento que se eliminó del vector original.
|
Emite
RangeError — Si el argumento index especifica la eliminación de un índice situado fuera de los límites del vector.
| |
RangeError — Si se llama a este método cuando fixed es true .
|
reverse | () | método |
AS3 function reverse():Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Invierte el orden de los elementos del vector. Este método altera el vector en el que se llama.
Valor devueltoVector.<T> — El vector con los elementos en orden inverso.
|
shift | () | método |
AS3 function shift():T
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
Valor devueltoT — El primer elemento del vector.
|
Emite
RangeError — Si fixed es true .
|
Elementos de API relacionados
slice | () | método |
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
startIndex:int (default = 0 ) — Un número que especifica el índice del punto inicial para la división. Si startIndex es un número negativo, el punto inicial comenzará al final del vector, donde -1 es el último elemento.
| |
endIndex:int (default = 16777215 ) — Un número que especifica el índice del punto final para la división. Si omite este parámetro, la división incluirá todos los elementos desde el punto inicial hasta el final del vector. Si endIndex es un número negativo, el punto final se especificará desde el final del vector, donde -1 es el último elemento.
|
Vector.<T> — un vector está formado por un rango de elementos del vector original.
|
some | () | método |
AS3 function some(callback:Function, thisObject:Object = null):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
callback:Function — La función que se va a ejecutar en cada elemento del vector. Esta función se invoca con tres argumentos: el elemento activo del vector, el índice del elemento y el objeto Vector:
function callback(item:T, index:int, vector:Vector.<T>):Boolean La función callback debe devolver un valor Boolean. | |
thisObject:Object (default = null ) — El objeto al que hace referencia el identificador this en la función callback cuando se llama a la función.
|
Boolean — Se devuelve el valor booleano true si algún elemento del vector devuelve true para la función especificada; en caso contrario se devuelve false .
|
Elementos de API relacionados
sort | () | método |
AS3 function sort(sortBehavior:*):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
ey
, la función devuelve uno de los tres valores siguientes:- un número negativo; si
x
debe aparecer antes quey
en la secuencia ordenada - 0; si
x
es igual ay
- un número positivo; si
x
debe aparecer después dey
en la secuencia ordenada
- un número negativo; si
- 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".
- 1 o
Parámetros
sortBehavior:* — Un valor de Function o Number que determina el comportamiento de la ordenación. Un parámetro Function especifica un método de comparación. Un valor de Number especifica las opciones de ordenación.
|
Vector.<T> — Objeto Vector con los elementos en el nuevo orden.
|
Elementos de API relacionados
splice | () | método |
AS3 function splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
startIndex:int — Un entero que especifica el índice del elemento del vector donde comienza la inserción o eliminación. Puede utilizar un entero negativo para especificar una posición relativa al final del vector (por ejemplo, -1 es el último elemento del vector).
| |
deleteCount:uint (default = 4294967295 ) — Un entero que especifica el número de elementos que se van a eliminar. Este número incluye el elemento especificado en el parámetro startIndex . Si el valor es 0, no se eliminará ningún elemento.
| |
... items — Una lista opcional de uno o varios valores separados por comas para insertar en el vector en la posición especificada en el parámetro startIndex .
|
Vector.<T> — un vector que contiene los elementos eliminados del vector original.
|
Emite
RangeError — Si los argumentos startIndex y deleteCount especifican la eliminación de un índice situado fuera de los límites del vector.
| |
RangeError — Si se llama a este método mientras fixed es true y la operación splice() cambia la longitud del vector.
|
toLocaleString | () | método |
public function toLocaleString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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()
.
String — Una cadena de elementos del vector.
|
Elementos de API relacionados
toString | () | método |
public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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()
.
String — Una cadena de elementos del vector.
|
Elementos de API relacionados
unshift | () | método |
AS3 function unshift(... args):uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
... args — Una o más instancias del tipo base del vector que se va a insertar al principio del objeto Vector.
|
uint — Un entero que representa la nueva longitud del vector.
|
Emite
TypeError — Si algún argumento no es una instancia del tipo base T del vector.
| |
RangeError — Si se llama a este método cuando fixed es true .
|
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z