Disponibilidad
Flash Player 5; se han añadido funciones adicionales en Flash Player 7.
Sintaxis
my_array.sort()
my_array.sort(compareFunction)
my_array.sort(option | option |... )
my_array.sort(compareFunction, option | option |... )
Array.slice()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.slice( [ start [ , end ] ] )
Parámetros
start Número que especifica el índice del punto de inicio de la sección. Si start es un número negativo, el punto de inicio comienza al final de la matriz, donde -1 es el último elemento.
end Número que especifica el índice del punto final de la sección. Si omite este parámetro, la sección incluirá todos los elementos desde el inicio hasta el final de la matriz. Si end es un número negativo, el punto final se especifica desde el final de la matriz, donde -1 es el último elemento.
Valor devuelto
Una matriz.
Descripción
Método; extrae una sección o una subcadena de la matriz y la devuelve como una nueva matriz sin modificar la matriz original. La matriz devuelta incluye el elemento start y todos los elementos hasta el elemento end, pero sin incluir este último.
Si no se pasa ningún parámetro, se creará un duplicado de my_array.
Ejemplo
my_array = ["uno", "dos", "tres", "cuatro"];
trace(my_array.join());
//devuelve uno,dos,tres,cuatro
array_slice1 = my_array.slice(0, 2);
trace(array_slice1.join());
//devuelve uno, dos
Flash Player 5.
Sintaxis
my_array.slice( [ start [ , end ] ] )
Parámetros
start Número que especifica el índice del punto de inicio de la sección. Si start es un número negativo, el punto de inicio comienza al final de la matriz, donde -1 es el último elemento.
end Número que especifica el índice del punto final de la sección. Si omite este parámetro, la sección incluirá todos los elementos desde el inicio hasta el final de la matriz. Si end es un número negativo, el punto final se especifica desde el final de la matriz, donde -1 es el último elemento.
Valor devuelto
Una matriz.
Descripción
Método; extrae una sección o una subcadena de la matriz y la devuelve como una nueva matriz sin modificar la matriz original. La matriz devuelta incluye el elemento start y todos los elementos hasta el elemento end, pero sin incluir este último.
Si no se pasa ningún parámetro, se creará un duplicado de my_array.
Ejemplo
my_array = ["uno", "dos", "tres", "cuatro"];
trace(my_array.join());
//devuelve uno,dos,tres,cuatro
array_slice1 = my_array.slice(0, 2);
trace(array_slice1.join());
//devuelve uno, dos
Array.shift()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.shift()
Parámetros
Ninguno.
Valor devuelto
El primer elemento de una matriz.
Descripción
Método; elimina el primer elemento de una matriz y devuelve ese elemento.
Ejemplo
En el código siguiente se crea la matriz myPets y, a continuación, se elimina el primer elemento de la matriz y se asigna a la variable shifted.
var myPets_array = ["gato", "perro", "pájaro", "pez"];
shifted = myPets_array.shift();
trace(shifted);
// devuelve "gato"
//myPets_array = ["perro", "pájaro", "pez"];
Véase también
Array.pop()
Flash Player 5.
Sintaxis
my_array.shift()
Parámetros
Ninguno.
Valor devuelto
El primer elemento de una matriz.
Descripción
Método; elimina el primer elemento de una matriz y devuelve ese elemento.
Ejemplo
En el código siguiente se crea la matriz myPets y, a continuación, se elimina el primer elemento de la matriz y se asigna a la variable shifted.
var myPets_array = ["gato", "perro", "pájaro", "pez"];
shifted = myPets_array.shift();
trace(shifted);
// devuelve "gato"
//myPets_array = ["perro", "pájaro", "pez"];
Véase también
Array.pop()
Array.reverse()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.reverse()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; invierte la matriz.
Ejemplo
A continuación se muestra un ejemplo del uso de este método.
var numbers_array = [1, 2, 3, 4, 5, 6];
trace(numbers_array.join());
//1,2,3,4,5,6
numbers_array.reverse();
trace(numbers_array.join());
// 6,5,4,3,2,1
Flash Player 5.
Sintaxis
my_array.reverse()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; invierte la matriz.
Ejemplo
A continuación se muestra un ejemplo del uso de este método.
var numbers_array = [1, 2, 3, 4, 5, 6];
trace(numbers_array.join());
//1,2,3,4,5,6
numbers_array.reverse();
trace(numbers_array.join());
// 6,5,4,3,2,1
Array.push()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.push(value,...)
Parámetros
value Uno o más valores que se anexan a la matriz.
Valor devuelto
La longitud de la nueva matriz.
Descripción
Método; añade uno o más elementos al final de una matriz y devuelve la nueva longitud de la matriz.
Ejemplo
En el ejemplo siguiente se crea la matriz myPets con dos elementos, gato y perro. En la segunda línea se agregan dos elementos a la matriz. Después de llamar al método push(), la variable pushed contiene cuatro elementos. Puesto que el método push() devuelve la nueva longitud de la matriz, la acción trace() de la última línea envía la nueva longitud de myPets (4) al panel Salida:
myPets = ["gato", "perro"];
pushed = myPets.push("pájaro", "pez");
trace(pushed);
//devuelve
//myPets=["gato", "perro", "pájaro", "pez"];
Flash Player 5.
Sintaxis
my_array.push(value,...)
Parámetros
value Uno o más valores que se anexan a la matriz.
Valor devuelto
La longitud de la nueva matriz.
Descripción
Método; añade uno o más elementos al final de una matriz y devuelve la nueva longitud de la matriz.
Ejemplo
En el ejemplo siguiente se crea la matriz myPets con dos elementos, gato y perro. En la segunda línea se agregan dos elementos a la matriz. Después de llamar al método push(), la variable pushed contiene cuatro elementos. Puesto que el método push() devuelve la nueva longitud de la matriz, la acción trace() de la última línea envía la nueva longitud de myPets (4) al panel Salida:
myPets = ["gato", "perro"];
pushed = myPets.push("pájaro", "pez");
trace(pushed);
//devuelve
//myPets=["gato", "perro", "pájaro", "pez"];
Array.pop()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.pop()
Parámetros
Ninguno.
Valor devuelto
El valor del último elemento de la matriz especificada.
Descripción
Método; elimina el último elemento de una matriz y devuelve el valor de ese elemento.
Ejemplo
En el código siguiente se crea la matriz myPets que contiene cuatro elementos y después se elimina su último elemento.
myPets = ["gato", "perro", "pájaro", "pez"];
popped = myPets.pop();
trace(popped);// devuelve pez
Flash Player 5.
Sintaxis
my_array.pop()
Parámetros
Ninguno.
Valor devuelto
El valor del último elemento de la matriz especificada.
Descripción
Método; elimina el último elemento de una matriz y devuelve el valor de ese elemento.
Ejemplo
En el código siguiente se crea la matriz myPets que contiene cuatro elementos y después se elimina su último elemento.
myPets = ["gato", "perro", "pájaro", "pez"];
popped = myPets.pop();
trace(popped);// devuelve pez
Array.length
Disponibilidad
Flash Player 5.
Sintaxis
my_array.length
Descripción
Propiedad; número entero que no es de base cero y que especifica el número de elementos de la matriz. Esta propiedad se actualiza automáticamente cuando se agregan nuevos elementos a la matriz. Cuando se asigna un valor a un elemento de matriz (por ejemplo, my_array[index] = valor), si index es un número e index+1 es mayor que la propiedad length, la propiedad length se actualiza a index+1.
Ejemplo
En el código siguiente se explica cómo se actualiza la propiedad length.
my_array = new Array();
trace(my_array.length);
// la longitud inicial es 0
my_array[0] = 'a';
trace(my_array.length);
// my_array.length se actualiza a 1
my_array[1] = 'b';
trace(my_array.length);
// my_array.length se actualiza a 2
my_array[9] = 'c';
trace(my_array.length);
// my_array.length se actualiza a 10
Flash Player 5.
Sintaxis
my_array.length
Descripción
Propiedad; número entero que no es de base cero y que especifica el número de elementos de la matriz. Esta propiedad se actualiza automáticamente cuando se agregan nuevos elementos a la matriz. Cuando se asigna un valor a un elemento de matriz (por ejemplo, my_array[index] = valor), si index es un número e index+1 es mayor que la propiedad length, la propiedad length se actualiza a index+1.
Ejemplo
En el código siguiente se explica cómo se actualiza la propiedad length.
my_array = new Array();
trace(my_array.length);
// la longitud inicial es 0
my_array[0] = 'a';
trace(my_array.length);
// my_array.length se actualiza a 1
my_array[1] = 'b';
trace(my_array.length);
// my_array.length se actualiza a 2
my_array[9] = 'c';
trace(my_array.length);
// my_array.length se actualiza a 10
Array.join()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.join([separator])
Parámetros
separator Carácter o cadena que separa los elementos de la matriz en la cadena devuelta. Si omite este parámetro, se utiliza la coma como separador predeterminado.
Valor devuelto
Una cadena.
Flash Player 5.
Sintaxis
my_array.join([separator])
Parámetros
separator Carácter o cadena que separa los elementos de la matriz en la cadena devuelta. Si omite este parámetro, se utiliza la coma como separador predeterminado.
Valor devuelto
Una cadena.
Array.concat()
Disponibilidad
Flash Player 5.
Sintaxis
my_array.concat( [ value0,value1,...valueN ])
Parámetros
value0,...valueN Números, elementos o cadenas que se van a concatenar en una nueva matriz. Si no se pasa ningún valor, se creará un duplicado de my_array.
Flash Player 5.
Sintaxis
my_array.concat( [ value0,value1,...valueN ])
Parámetros
value0,...valueN Números, elementos o cadenas que se van a concatenar en una nueva matriz. Si no se pasa ningún valor, se creará un duplicado de my_array.
Constructor para la clase Array
Disponibilidad
Flash Player 5.
Sintaxis
new Array()
new Array(length)
new Array(element0, element1, element2,...elementN)
Parámetros
length Número entero que especifica el número de elementos de la matriz. En el caso de elementos no contiguos,el parámetro length especifica el número de índice del último elemento de la matriz más 1.
element0...elementN Lista de dos o más valores arbitrarios. Los valores pueden ser números, cadenas, objetos u otras matrices. El primer elemento de una matriz siempre tiene el índice o posición 0.
Flash Player 5.
Sintaxis
new Array()
new Array(length)
new Array(element0, element1, element2,...elementN)
Parámetros
length Número entero que especifica el número de elementos de la matriz. En el caso de elementos no contiguos,el parámetro length especifica el número de índice del último elemento de la matriz más 1.
element0...elementN Lista de dos o más valores arbitrarios. Los valores pueden ser números, cadenas, objetos u otras matrices. El primer elemento de una matriz siempre tiene el índice o posición 0.
Clase Array
Disponibilidad
Flash Player 5 (pasó a ser un objeto nativo en Flash Player 6, lo cual mejoró el rendimiento notablemente).
Descripción
La clase Array permite acceder a matrices y manipularlas. Una matriz es un objeto cuyas propiedades se identifican con un número que representa su posición en la matriz. Este número se denomina índice. Todas las matrices tienen base cero, lo que quiere decir que el primer elemento de la matriz es [0], el segundo elemento es [1] y así sucesivamente. En el ejemplo siguiente, my_Array contiene los meses del año.
my_array[0] = "Enero"
my_array[1] = "Febrero"
my_array[2] = "Marzo"
my_array[3] = "Abril"
Flash Player 5 (pasó a ser un objeto nativo en Flash Player 6, lo cual mejoró el rendimiento notablemente).
Descripción
La clase Array permite acceder a matrices y manipularlas. Una matriz es un objeto cuyas propiedades se identifican con un número que representa su posición en la matriz. Este número se denomina índice. Todas las matrices tienen base cero, lo que quiere decir que el primer elemento de la matriz es [0], el segundo elemento es [1] y así sucesivamente. En el ejemplo siguiente, my_Array contiene los meses del año.
my_array[0] = "Enero"
my_array[1] = "Febrero"
my_array[2] = "Marzo"
my_array[3] = "Abril"
arguments.length
Disponibilidad
Flash Player 5.
Sintaxis
arguments.length
Descripción
Propiedad; el número de parámetros que se han pasado realmente a una función.
Flash Player 5.
Sintaxis
arguments.length
Descripción
Propiedad; el número de parámetros que se han pasado realmente a una función.
arguments.caller
Disponibilidad
Flash Player 6.
Sintaxis
arguments.caller
Descripción
Propiedad; hace referencia a la función que llama.
Flash Player 6.
Sintaxis
arguments.caller
Descripción
Propiedad; hace referencia a la función que llama.
arguments.callee
Disponibilidad
Flash Player 5.
Sintaxis
arguments.callee
Descripción
Propiedad; hace referencia a la función a la que se está llamando en este momento.
Ejemplo
Puede utilizar la propiedad arguments.callee para realizar una función anónima que es recursiva, como se muestra a continuación:
factorial = function (x) {
if (x <= 1) {
return 1;
} else {
return x * arguments.callee(x-1);
}
};
A continuación se muestra una función recursiva con nombre:
function factorial (x) {
if (x <= 1) {
return 1;
} else {
return x * factorial(x-1);
}
}
Flash Player 5.
Sintaxis
arguments.callee
Descripción
Propiedad; hace referencia a la función a la que se está llamando en este momento.
Ejemplo
Puede utilizar la propiedad arguments.callee para realizar una función anónima que es recursiva, como se muestra a continuación:
factorial = function (x) {
if (x <= 1) {
return 1;
} else {
return x * arguments.callee(x-1);
}
};
A continuación se muestra una función recursiva con nombre:
function factorial (x) {
if (x <= 1) {
return 1;
} else {
return x * factorial(x-1);
}
}
Clase Arguments
Disponibilidad
Flash Player 5; propiedad añadida en Flash Player 6.
Descripción
La clase Arguments es una matriz que contiene los valores que se han pasado como parámetros a cualquier función. Cada vez que se llama a una función en ActionScript, se crea de forma automática un objeto Arguments para esa función. Se crea también una variable local, arguments, que permite hacer referencia al objeto Arguments.
Resumen de propiedades para la clase Arguments
arguments.callee
Hace referencia a la función a la que se está llamando.
arguments.caller
Hace referencia a la función que llama.
arguments.length
El número de parámetros pasados a una función.
Flash Player 5; propiedad añadida en Flash Player 6.
Descripción
La clase Arguments es una matriz que contiene los valores que se han pasado como parámetros a cualquier función. Cada vez que se llama a una función en ActionScript, se crea de forma automática un objeto Arguments para esa función. Se crea también una variable local, arguments, que permite hacer referencia al objeto Arguments.
Resumen de propiedades para la clase Arguments
arguments.callee
Hace referencia a la función a la que se está llamando.
arguments.caller
Hace referencia a la función que llama.
arguments.length
El número de parámetros pasados a una función.
and
Disponibilidad
Flash Player 4.
Sintaxis
condition1 and condition2
Parámetros
condition1,condition2 Condiciones o expresiones que dan como resultado true o false.
Valor devuelto
Ninguno.
Descripción
Operador; realiza una operación AND lógica en Flash Player 4. Si ambas expresiones dan como resultado true, toda la expresión es true. Este operador se eliminó en la versión Flash 5 y Macromedia recomienda utilizar el operador &&.
Flash Player 4.
Sintaxis
condition1 and condition2
Parámetros
condition1,condition2 Condiciones o expresiones que dan como resultado true o false.
Valor devuelto
Ninguno.
Descripción
Operador; realiza una operación AND lógica en Flash Player 4. Si ambas expresiones dan como resultado true, toda la expresión es true. Este operador se eliminó en la versión Flash 5 y Macromedia recomienda utilizar el operador &&.
add
Disponibilidad
Flash Player 4.
Sintaxis
string1 add string2
Parámetros
string1, string2 Una cadena.
Valor devuelto
Ninguno.
Descripción
Flash Player 4.
Sintaxis
string1 add string2
Parámetros
string1, string2 Una cadena.
Valor devuelto
Ninguno.
Descripción
Operador; concatena (combina) dos o más cadenas. El operador add sustituye al operador add (&) de Flash 4; cuando los archivos de Flash Player 4 que utilizan el operador & se utilizan en un entorno de edición Flash 5 o posterior, se convierten automáticamente para utilizar el operador add para la concatenación de cadenas. No obstante, el operador add se ha eliminado de Flash Player 5, y Macromedia recomienda utilizar el operador + cuando se crea contenido para Flash Player 5 o una versión posterior. Utilice el operador add para concatenar cadenas si está creando contenido para Flash Player 4 o para versiones anteriores del reproductor.
Accessibility.updateProperties()
Disponibilidad
Flash Player 6 versión 65.
Sintaxis
Accessibility.updateProperties()
Parámetros
Ninguno.
Valor devuelto
Ninguno.
Descripción
Método; hace que Flash Player vuelva a examinar todas las propiedades de accesibilidad, actualice la descripción de los objetos para los lectores de pantalla y, si es necesario, envíe eventos a los lectores de pantalla para indicar que se han producido cambios.
Accessibility.isActive()
Disponibilidad
Flash Player 6 versión 65.
Sintaxis
Accessibility.isActive()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano de true si hay clientes de Microsoft Active Accessibility (MSAA) activos y el reproductor se está ejecutando en un entorno que admite comunicación entre Flash Player y las ayudas de accesibilidad; false en caso contrario.
Flash Player 6 versión 65.
Sintaxis
Accessibility.isActive()
Parámetros
Ninguno.
Valor devuelto
Un valor booleano de true si hay clientes de Microsoft Active Accessibility (MSAA) activos y el reproductor se está ejecutando en un entorno que admite comunicación entre Flash Player y las ayudas de accesibilidad; false en caso contrario.
Clase Accessibility
Disponibilidad
Flash Player 6 versión 65.
Descripción
Descripción
La clase Accessibility gestiona la comunicación con los lectores de pantalla. Los métodos de la clase Accessibility son estáticos, es decir, no es necesario crear una instancia de la clase para utilizarlos.
Para obtener y establecer las propiedades accesibles para un objeto específico, como por ejemplo un botón, un clip de película o un campo de texto, utilice la propiedad _accProps. Para determinar si el reproductor se está ejecutando en un entorno que admite ayudas de accesibilidad, use System.capabilities.hasAccessibility.
Resumen de métodos para la clase Accessibility
Accessibility.isActive()
Indica si hay activo un programa de lectura en pantalla.
Accessibility.updateProperties()
Actualiza la descripción de los objetos de la pantalla para los lectores de pantalla.
Entrada de muestra para clases
En la siguiente entrada de muestra del diccionario se explican las convenciones utilizadas para las clases de ActionScript incorporadas. Las clases se enumeran alfabéticamente junto con los demás elementos del diccionario.
Entrada de muestra para la mayoría de los elementos de ActionScript
En la siguiente entrada de muestra del diccionario se explican las convenciones utilizadas para todos los elementos de ActionScript que no son clases.
Introducción al Diccionario de ActionScript
En este diccionario se describen la sintaxis y la utilización de los elementos de ActionScript en Macromedia Flash. Para utilizar ejemplos en un script, copie el código de ejemplo de este diccionario y péguelo en el panel Script o en un archivo de script externo.
El diccionario enumera todos los elementos de ActionScript: operadores, palabras clave, declaraciones, acciones, propiedades, funciones, clases y métodos.
El diccionario enumera todos los elementos de ActionScript: operadores, palabras clave, declaraciones, acciones, propiedades, funciones, clases y métodos.
Existen dos tipos de entradas en este diccionario:
Suscribirse a:
Entradas (Atom)