String

Paquete	Nivel superior
Clase	public final class String
Herencia	String Object

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

La clase String es un tipo de datos que representa una cadena de caracteres. La clase String proporciona métodos y propiedades que le permiten manipular tipos de valores de cadena simples. Puede convertir el valor de cualquier objeto en un objeto de tipo de datos String utilizando la función String().

Dado que todos los índices de cadenas están basados en cero, el índice del último carácter de cualquier cadena x es x.length - 1.

Puede llamar a cualquiera de los métodos de la clase String tanto si utiliza el método constructor new String() para crear una nueva variable de cadena como si simplemente asigna un valor de literal de cadena. A diferencia de versiones anteriores de ActionScript, da igual que se utilice el constructor, la función global o simplemente se asigne un valor de literal de cadena. Las siguientes líneas de código son equivalentes:

 var str:String = new String("foo");
 var str:String = "foo";
 var str:String = String("foo");

Al definir una variable de cadena con el valor undefined, los motores de ejecución de Flash fuerzan undefined a tener el valor null. De manera que, la sentencia:

 var s:String = undefined;

define el valor como null en lugar de undefined. Utilice la función String() si necesita utilizar undefined.

Ver los ejemplos

Elementos de API relacionados

Función global String()

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		length : int [solo lectura] Un entero que especifica el número de caracteres del objeto String especificado.	String

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		String(val:String) Crea un nuevo objeto String inicializado con la cadena especificada.	String
		charAt(index:Number = 0):String Devuelve el carácter situado en la posición especificada por el parámetro index.	String
		charCodeAt(index:Number = 0):Number Devuelve el código de carácter numérico Unicode del carácter situado en el index especificado.	String
		concat(... args):String Añade los argumentos proporcionados al final del objeto String, los convierte en cadenas si es necesario y devuelve la cadena resultante.	String
		fromCharCode(... charCodes):String [estática] Devuelve una cadena formada por los caracteres representados por los códigos de caracteres Unicode de los parámetros.	String
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		indexOf(val:String, startIndex:Number = 0):int Busca la cadena y devuelve la posición en la que aparece por primera vez val en la posición de startIndex o después de dicha posición dentro de la cadena que origina la llamada.	String
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		lastIndexOf(val:String, startIndex:Number = 0x7FFFFFFF):int Busca la cadena de derecha a izquierda y devuelve el índice de la última posición en que aparece val antes que startIndex.	String
		localeCompare(other:String, ... values):int Compara el orden de clasificación de dos o más cadenas y devuelve el resultado de la comparación como un entero.	String
		match(pattern:*):Array Establece la correspondencia del patrón pattern especificado con la cadena.	String
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		replace(pattern:*, repl:Object):String Establece la correspondencia del patrón especificado con la cadena y devuelve una nueva cadena en la que la primera coincidencia del patrón se sustituye por el contenido especificado por repl.	String
		search(pattern:*):int Busca el patrón pattern especificado y devuelve el índice de la primera subcadena coincidente.	String
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		slice(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String Devuelve una cadena que incluye el carácter inicial startIndex y todos los caracteres que aparecen hasta el carácter final endIndex, exclusive.	String
		split(delimiter:*, limit:Number = 0x7fffffff):Array Divide un objeto String en un conjunto de subcadenas fragmentándolo siempre que aparece el parámetro delimiter especificado.	String
		substr(startIndex:Number = 0, len:Number = 0x7fffffff):String Devuelve una subcadena formada por los caracteres que comienzan en el valor de startIndex especificado y que tienen una longitud especificada por Ien.	String
		substring(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String Devuelve una cadena formada por el carácter especificado por startIndex y por todos los caracteres hasta endIndex - 1.	String
		toLocaleLowerCase():String Devuelve una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas.	String
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toLocaleUpperCase():String Devuelve una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas.	String
		toLowerCase():String Devuelve una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas.	String
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		toUpperCase():String Devuelve una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas.	String
		valueOf():String Devuelve el valor simple de una instancia String.	String

Información sobre propiedades

length

propiedad

length:int [solo lectura]

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Un entero que especifica el número de caracteres del objeto String especificado.

Dado que todos los índices de cadenas están basados en cero, el índice del último carácter de cualquier cadena x es x.length - 1.

Implementación
public function get length():int

Información sobre constructores

()

Información sobre

public function String(val:String)

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Crea un nuevo objeto String inicializado con la cadena especificada.

Nota: dado que los literales de cadena utilizan menos espacio que los objetos String y son generalmente más fáciles de usar, deberá utilizar literales de cadena en lugar de la clase String a no ser que exista un motivo específico para utilizar un objeto String en lugar de un literal de cadena.

Parámetros

val:String — Valor inicial del nuevo objeto String.

Información sobre métodos

charAt

()

método

AS3 function charAt(index:Number = 0):String

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve el carácter situado en la posición especificada por el parámetro index. Si index no es un número entre 0 y string.length - 1, se devolverá una cadena vacía.

Este método es igual que String.charCodeAt(), con la diferencia de que el valor devuelto es un carácter, no un código de carácter de entero de 16 bits.

Parámetros

index:Number (default = 0) — Un entero que especifica la posición de un carácter en la cadena. El primer carácter se indica por 0 y el último por my_str.length - 1.

Valor devuelto

String — El carácter situado en el índice especificado. O una cadena vacía si el índice especificado está fuera del rango de los índices de esta cadena.

Elementos de API relacionados

charCodeAt()

charCodeAt

()

método

AS3 function charCodeAt(index:Number = 0):Number

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve el código de carácter numérico Unicode del carácter situado en el index especificado. Si index no es un número entre 0 y string.length - 1, se devolverá NaN.

Este método es igual que String.charAt(), con la diferencia de que el valor devuelto es un código de carácter de entero de 16 bits, no el carácter en sí.

Parámetros

index:Number (default = 0) — Un entero que especifica la posición de un carácter en la cadena. El primer carácter se indica con 0, y el último con my_str.length - 1.

Valor devuelto

Number — El código de carácter Unicode del carácter situado en el índice especificado. O NaN si el índice está fuera del rango de los índices de esta cadena.

Los valores Unicode se definen en la especificación de base de datos de caracteres Unicode.

Elementos de API relacionados

charAt()

concat

()

método

AS3 function concat(... args):String

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Añade los argumentos proporcionados al final del objeto String, los convierte en cadenas si es necesario y devuelve la cadena resultante. El valor original del objeto String de origen permanece sin cambios.

Parámetros

... args — Cero o más valores para concatenar.

Valor devuelto

String — Una nueva cadena que consta de esta cadena concatenada con los parámetros especificados.

fromCharCode

()

método

AS3 static function fromCharCode(... charCodes):String

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve una cadena formada por los caracteres representados por los códigos de caracteres Unicode de los parámetros.

Parámetros

... charCodes — Una serie de enteros decimales que representan valores Unicode.

Los valores Unicode se definen en la especificación de base de datos de caracteres Unicode.

Valor devuelto

String — El valor de cadena de los códigos de caracteres Unicode especificados.

indexOf

()

método

AS3 function indexOf(val:String, startIndex:Number = 0):int

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Busca la cadena y devuelve la posición en la que aparece por primera vez val en la posición de startIndex o después de dicha posición dentro de la cadena que origina la llamada. Este índice está basado en cero, con lo cual se considera que el primer carácter está en el índice 0, no en el índice 1. Si no se encuentra val, el método devuelve -1.

Parámetros

	`val:String` — La subcadena que se debe buscar.

	`startIndex:Number` (default = `0`) — Un entero opcional que especifica el índice inicial de la búsqueda.

Valor devuelto

int — El índice en que aparece por primera vez la subcadena especificada o -1.

Elementos de API relacionados

lastIndexOf()

lastIndexOf

()

método

AS3 function lastIndexOf(val:String, startIndex:Number = 0x7FFFFFFF):int

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Busca la cadena de derecha a izquierda y devuelve el índice de la última posición en que aparece val antes que startIndex. El índice está basado en cero, lo que significa que el primer carácter se encuentra en el índice 0 y el último en string.length - 1. Si no se encuentra val, el método devuelve -1.

Parámetros

	`val:String` — La cadena que se busca.

	`startIndex:Number` (default = `0x7FFFFFFF`) — Un entero opcional que especifica el índice de inicio de la búsqueda de `val`. El valor predeterminado es el valor máximo permitido para un índice. Si no se especifica `startIndex`, la búsqueda comenzará en el último elemento de la cadena.

Valor devuelto

int — La posición en que aparece por última vez la subcadena especificada o -1 si no se encuentra.

Elementos de API relacionados

indexOf()

localeCompare

()

método

AS3 function localeCompare(other:String, ... values):int

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Compara el orden de clasificación de dos o más cadenas y devuelve el resultado de la comparación como un entero. Aunque este método está pensado para gestionar la comparación de forma específica para una localización, la implementación ActionScript 3.0 no produce un resultado diferente de otras comparaciones de cadenas tales como las de los operadores de igualdad (==) o desigualdad (!=). Si las cadenas son equivalentes, el valor devuelto es 0. Si el valor de cadena original precede al valor de cadena especificado por other, el valor devuelto es un entero negativo cuyo valor absoluto representa el número de caracteres que separan los dos valores de cadena. Si el valor de cadena original va después de other, el valor devuelto es un entero positivo cuyo valor absoluto representa el número de caracteres que separan los dos valores de cadena.

Parámetros

	`other:String` — Un valor de cadena que se va a comparar.

	`... values` — Conjunto opcional de otras cadenas con las que comparar.

Valor devuelto

int — El valor es 0 si las cadenas son iguales. En caso contrario, el valor es un entero negativo si la cadena original precede al argumento de cadena y un entero positivo si el argumento de cadena precede a la cadena original. En ambos casos, el valor absoluto del número representa la diferencia entre las dos cadenas.

match

()

método

AS3 function match(pattern:*):Array

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Establece la correspondencia del patrón pattern especificado con la cadena.

Parámetros

Valor devuelto

Array — Un conjunto de cadenas que consta de todas las subcadenas de la cadena que coinciden con el patrón pattern especificado.

Si pattern es una expresión normal, para que se devuelva un conjunto con más de una subcadena coincidente, debe definirse el indicador g (global) en la expresión normal:

Si el indicador g (global) no está definido, el conjunto devuelto no contendrá más de una coincidencia y la propiedad lastIndex de la expresión normal permanecerá sin cambios.
Si el indicador g (global) is definido, el método comienza la búsqueda al principio de la cadena (posición de índice 0). Si una subcadena coincidente es una cadena vacía (lo que puede ocurrir con una expresión normal como /x*/), el método añade una cadena vacía al conjunto de coincidencias y continúa buscando en la siguiente posición de índice. La propiedad lastIndex de la expresión normal se define como 0 después de que finalice el método.

Cuando el parámetro pattern es una expresión regular con el indicador g (global) definido, el método devuelve un objeto Array vacío si no se encuentra ninguna coincidencia. Si el parámetro pattern es un objeto String o una expresión regular no global y no se encuentra ninguna coincidencia, el método devuelve null. Si no pasa ningún valor (o pasa un valor no definido, undefined) como parámetro de pattern, el método devolverá null.

Elementos de API relacionados

RegExp

replace

()

método

AS3 function replace(pattern:*, repl:Object):String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Establece la correspondencia del patrón pattern especificado con la cadena y devuelve una nueva cadena en la que la primera coincidencia de pattern se sustituye por el contenido especificado por repl. El parámetro pattern puede ser una cadena o una expresión normal. El parámetro repl puede ser una cadena o una función; si es una función, la cadena devuelta por la función se inserta en lugar de la coincidencia. La cadena original no se modifica.

En el siguiente ejemplo, sólo se sustituye la primera instancia de "sh" (con distinción entre mayúsculas y minúsculas):

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

En el siguiente ejemplo, todas las instancias de "sh" (con distinción entre mayúsculas y minúsculas) se sustituyen porque el indicador g (global) está definido en la expresión normal:

    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.

En el siguiente ejemplo, todas las instancias de "sh" se sustituyen porque el indicador g (global) está definido en la expresión normal y las coincidencias no distinguen entre mayúsculas y minúsculas, ya que está definido el indicador 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.

Parámetros

pattern:* — El patrón del que deben buscarse coincidencias, que puede ser cualquier tipo de objeto, aunque que suele ser una cadena o una expresión normal. Si especifica un parámetro pattern que sea un objeto diferente de una cadena o una expresión normal, el método toString() se aplica al parámetro y el método replace() se ejecuta empleando la cadena resultante como patrón pattern.

repl:Object — Normalmente, la cadena que se inserta en lugar del contenido coincidente. Sin embargo, también puede especificar una función para este parámetro. Si especifica una función, la cadena devuelta por la función se inserta en lugar del contenido coincidente.

Si especifica una cadena como parámetro repl y especifica una expresión normal como parámetro pattern, puede utilizar los siguientes códigos de sustitución $ especiales en la cadena repl:

Código $	Texto de reemplazo
`$$`	`$`
`$&`	La subcadena coincidente.
$`	La parte de la cadena que precede a la subcadena coincidente. Tenga en cuenta que este código utiliza el carácter de comilla simple recta hacia la izquierda (`), no el carácter de comilla simple recta (') ni el carácter de comilla simple curva hacia la izquierda (‘).
`$'`	La parte de la cadena que sigue a la subcadena coincidente. Tenga en cuenta que este código utiliza el carácter de comilla simple recta (').
`$`n	El nº grupo entre paréntesis coincidente captado, donde n es un único dígito entre 1 y 9 y `$`n no va seguido de un dígito decimal.
`$`nn	El nnº grupo entre paréntesis coincidente captado, donde nn es un número decimal de dos dígitos (01-99). Si la captura nnº no está definida, el texto de sustitución será una cadena vacía.

Por ejemplo, a continuación se muestra el uso de los códigos de sustitución $2 y $1, que representan el primer y el segundo grupo coincidente captado:

var str:String = "flip-flop";
    var pattern:RegExp = /(\w+)-(\w+)/g;
    trace(str.replace(pattern, "$2-$1")); // flop-flip

Al especificar una función como repl, el método replace() pasa los siguientes parámetros a la función:

La parte coincidente de la cadena.
Los grupos entre paréntesis coincidentes captados se proporcionan como los siguientes argumentos. El número de argumentos pasados de esta forma varía en función del número de grupos entre paréntesis coincidentes. Puede determinar el número de grupos entre paréntesis coincidentes comprobando arguments.length - 3 dentro del código de la función.
La posición de índice dentro de la cadena en la que comienza la coincidencia.
La cadena completa.

Por ejemplo, observe lo siguiente:

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

La llamada al método replace() utiliza una función como parámetro repl. Se establece la correspondencia con la expresión normal (/([a-z]([0-9]/g) dos veces. La primera vez, se establece la correspondencia del patrón con la subcadena "abc12" y se pasa a la función la siguiente lista de argumentos:

    {"abc12", "abc", "12", 0, "abc12 def34"}

La segunda vez, se establece la correspondencia del patrón con la subcadena "def23" y se pasa a la función la siguiente lista de argumentos:

    {"def34", "def", "34", 6, "abc123 def34"}

Valor devuelto

String — La cadena resultante. Tenga en cuenta que la cadena de origen permanece sin cambios.

Elementos de API relacionados

RegExp

search

()

método

AS3 function search(pattern:*):int

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Busca el patrón pattern especificado y devuelve el índice de la primera subcadena coincidente. Si no hay ninguna subcadena coincidente, el método devuelve -1.

Parámetros

pattern:* — El patrón del que deben buscarse coincidencias, que puede ser cualquier tipo de objeto, aunque que suele ser una cadena o una expresión normal. Si el patrón pattern no es una expresión normal o una cadena, el método lo convierte en una cadena antes de la ejecución. Tenga en cuenta que, si especifica una expresión normal, el método omitirá el indicador global ("g") de la expresión normal y omitirá la propiedad lastIndex de la expresión normal (y la dejará intacta). Si pasa un valor no definido (o no pasa ningún valor), el método devolverá -1.

Valor devuelto

int — El índice de la primera subcadena coincidente o -1 si no hay ninguna coincidencia. Tenga en cuenta que la cadena tiene un índice basado en cero; el primer carácter de la cadena se encuentra en el índice 0 y el último, en string.length - 1.

Elementos de API relacionados

RegExp

slice

()

método

AS3 function slice(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una cadena que incluye el carácter inicial (startIndex) y todos los caracteres que aparecen hasta el carácter endIndex, sin incluir éste último. El objeto String original no se modifica. Si no se especifica el parámetro endIndex, el final de la subcadena será el final de la cadena. Si el carácter indexado por startIndex es el mismo o está situado a la derecha del carácter indexado por endIndex, el método devolverá una cadena vacía.

Parámetros

	`startIndex:Number` (default = `0`) — El índice basado en cero del punto inicial de la división. Si `startIndex` es un número negativo, la división se crea de derecha a izquierda, siendo -1 el último carácter.

	`endIndex:Number` (default = `0x7fffffff`) — Un entero que es un número por encima del índice del punto final de la división. El carácter indexado por el parámetro `endIndex` no se incluye en la cadena extraída. Si `endIndex` es un número negativo, el punto final se establece desde el final de la cadena, donde -1 es el último carácter. El valor predeterminado es el valor máximo permitido para un índice. Si se omite este parámetro, se empleará `String.length`.

Valor devuelto

String — Una subcadena basada en los índices especificados.

Elementos de API relacionados

substr()
substring()

split

()

método

AS3 function split(delimiter:*, limit:Number = 0x7fffffff):Array

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Divide un objeto String en un conjunto de subcadenas fragmentándolo siempre que aparece el parámetro delimitador delimiter.

Si el parámetro delimiter es una expresión normal, sólo se tendrá en cuenta la primera coincidencia en una posición determinada, aunque el control hacia atrás pudiera encontrar una coincidencia de subcadena no vacía en dicha posición. Por ejemplo:

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

Si el parámetro delimiter es una expresión normal que contiene paréntesis de agrupaciones, cada vez que se encuentre delimiter, se unirán los resultados (incluidos los resultados no definidos) en el conjunto de salida. Por ejemplo

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

Si se especifica el parámetro limit, el conjunto devuelto sólo tendrá el número especificado de elementos.

Si delimiter es una cadena vacía, una expresión normal vacía o una expresión normal que puede coincidir con una cadena vacía, cada carácter individual de la cadena se incluye en la salida como un elemento del conjunto.

Si el parámetro delimiter tiene el valor undefined, se situará la cadena completa en el primer elemento del conjunto devuelto.

Parámetros

	`delimiter:*` — El patrón que especifica por dónde debe dividirse esta cadena. Puede ser cualquier tipo de objeto, aunque que suele ser una cadena o una expresión normal. Si el patrón `delimiter` no es una expresión normal o una cadena, el método lo convierte en una cadena antes de la ejecución.

	`limit:Number` (default = `0x7fffffff`) — El número máximo de elementos que deben incluirse en el conjunto. El valor predeterminado es el valor máximo permitido.

Valor devuelto

Array — Un conjunto de subcadenas.

Elementos de API relacionados

Array.join()
RegExp

substr

()

método

AS3 function substr(startIndex:Number = 0, len:Number = 0x7fffffff):String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una subcadena formada por los caracteres que comienzan en el valor de startIndex especificado y que tienen una longitud especificada por len. La cadena original permanece sin cambios.

Parámetros

	`startIndex:Number` (default = `0`) — Un entero que indica el índice del primer carácter que se va a utilizar para crear la subcadena. Si `startIndex` es un número negativo, el índice de inicio se establece desde el final de la cadena, donde `-1` es el último carácter.

	`len:Number` (default = `0x7fffffff`) — Número de caracteres de la subcadena que se va a crear. El valor predeterminado es el valor máximo permitido. Si no se especifica `len`, la subcadena incluye todos los caracteres desde `startIndex` hasta el final de la cadena.

Valor devuelto

String — Una subcadena basada en los parámetros especificados.

substring

()

método

AS3 function substring(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una cadena formada por el carácter especificado por startIndex y por todos los caracteres hasta endIndex - 1. Si no se especifica endIndex, se utilizará String.length. Si el valor de startIndex es igual al valor de endIndex, el método devolverá una cadena vacía. Si el valor de startIndex es mayor que el valor de endIndex, los parámetros se intercambiarán automáticamente antes de que se ejecute la función. La cadena original permanece sin cambios.

Parámetros

	`startIndex:Number` (default = `0`) — Un entero que especifica el índice del primer carácter utilizado para crear la subcadena. Los valores admitidos para `startIndex` son de `0` a `String.length`. Si `startIndex` es un valor negativo, se utiliza `0`.

	`endIndex:Number` (default = `0x7fffffff`) — Un entero que es un número mayor que el índice del último carácter de la subcadena extraída. Los valores admitidos para `endIndex` son de `0` a `String.length`. El carácter situado en `endIndex` no se incluye en la subcadena. El valor predeterminado es el valor máximo permitido para un índice. Si se omite este parámetro, se empleará `String.length`. Si este parámetro es un valor negativo, se utiliza `0`.

Valor devuelto

String — Una subcadena basada en los parámetros especificados.

toLocaleLowerCase

()

método

AS3 function toLocaleLowerCase():String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas. La cadena original permanece sin cambios. Aunque este método está pensado para gestionar la conversión de forma específica para una localización, la implementación ActionScript 3.0 no produce un resultado diferente del método toLowerCase().

Valor devuelto

String — Una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas.

Elementos de API relacionados

toLowerCase()

toLocaleUpperCase

()

método

AS3 function toLocaleUpperCase():String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas. La cadena original permanece sin cambios. Aunque este método está pensado para gestionar la conversión de forma específica para una localización, la implementación ActionScript 3.0 no produce un resultado diferente del método toUpperCase().

Valor devuelto

String — Una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas.

Elementos de API relacionados

toUpperCase()

toLowerCase

()

método

AS3 function toLowerCase():String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas. La cadena original permanece sin cambios.

Este método convierte todos los caracteres (no sólo A-Z) para los que existan equivalentes Unicode en minúsculas:

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

Estas asignaciones de caja se definen en la especificación de base de datos de caracteres Unicode.

Valor devuelto

String — Una copia de esta cadena con todos los caracteres en mayúsculas convertidos en minúsculas.

Elementos de API relacionados

toUpperCase()

toUpperCase

()

método

AS3 function toUpperCase():String

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas. La cadena original permanece sin cambios.

Este método convierte todos los caracteres (no sólo a-z) para los que existan equivalentes Unicode en mayúsculas:

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

Estas asignaciones de caja se definen en la especificación de base de datos de caracteres Unicode.

Valor devuelto

String — Una copia de esta cadena con todos los caracteres en minúsculas convertidos en mayúsculas.

Elementos de API relacionados

toLowerCase()

valueOf

()

método

AS3 function valueOf():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Lite 4, Flash Player 9, AIR 1.0

Devuelve el valor simple de una instancia String. Este método está diseñado para convertir un objeto String en un valor de cadena simple. Dado que los motores de ejecución de Flash llaman automáticamente a valueOf() cuando es preciso, sólo tendrá que llamar a este método explícitamente en casos poco frecuentes.

Valor devuelto

String — El valor de la cadena.

Ejemplos Cómo utilizar este ejemplo

StringExample.as

El siguiente ejemplo utiliza las clases StringExample y StringHelper para mostrar cómo se utilizan los distintos métodos de la clase String. Esto se consigue con los pasos siguientes:

El constructor de StringExample declara varias instancias locales de String, que se inicializan con diversas cadenas y un nuevo objeto StringHelper.
La clase StringHelper tiene los siguientes métodos:
- replace(): llama a los métodos split() y join() de String para eliminar una subcadena de la cadena transferida y sustituirla por una nueva.
- trim(): llama a los métodos trimBack() y trimFront() utilizando las cadenas transferidas y devuelve la cadena actualizada.
- trimFront(): elimina sucesivamente todos los caracteres que coinciden con el parámetro char, comenzando desde la parte inicial de la cadena hasta llegar al final, hasta que el primer carácter de la cadena no coincida con char; entonces devuelve la cadena actualizada.
- trimBack(): elimina sucesivamente todos los caracteres que coinciden con el parámetro char, comenzando desde el final de la cadena hasta llegar al principio, hasta que el último carácter de la cadena no coincida con char; entonces, devuelve la cadena actualizada.
- stringToCharacter(): devuelve el primer carácter de la cadena transferido.
A continuación, se generan tres cadenas con las variables de cadena declaradas: con una llamada al método replace() se genera la segunda cadena, y con una llamada a trim() se genera la tercera cadena.

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

Avisos legales | Política de privacidad en línea

String - AS3

Clases x

length

String

charAt

charCodeAt

concat

fromCharCode

indexOf

lastIndexOf

localeCompare

match

replace

search

slice

split

substr

substring

toLocaleLowerCase

toLocaleUpperCase

toLowerCase

toUpperCase

valueOf