String

Pacote	Nível superior
Classe	public final class String
Herança	String Object

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

A classe String é um tipo de dados que representa uma string de caracteres. A classe String fornece métodos e propriedades que permitem manipular tipos de valores de string primitivos. É possível converter o valor de qualquer objeto em um objeto do tipo de dados String usando a função String().

Como todos os índices de string são baseados em zero, o índice do último caractere de qualquer string x é x.length - 1.

Você pode chamar qualquer um dos métodos da classe String independentemente de usar o método de construtor new String() para criar uma nova variável de string ou simplesmente atribuir um valor literal de string. Ao contrário das versões anteriores do ActionScript, não faz diferença se você usa o construtor, a função global ou se simplesmente atribui um valor literal de string. As linhas de código a seguir são equivalentes:

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

Ao definir uma variável de string como undefined, os tempos de execução do Flash forçam undefined para null. Dessa forma, a instrução:

 var s:String = undefined;

define o valor como null em vez de undefined. Use a função String() se precisar usar undefined.

Veja os exemplos

Elementos da API relacionados

Função global String()

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		length : int [somente leitura] Um inteiro que especifica o número de caracteres no objeto String especificado.	String

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		String(val:String) Cria um novo objeto String inicializado para a string especificada.	String
		charAt(index:Number = 0):String Retorna o caractere na posição especificada pelo parâmetro índice.	String
		charCodeAt(index:Number = 0):Number Retorna o código de caractere Unicode numérico do caractere no índice especificado.	String
		concat(... args):String Acrescenta os argumentos fornecidos ao final do objeto String, convertendo-os em strings se necessário, e retorna a string resultante.	String
		fromCharCode(... charCodes):String [estático] Retorna uma string que compreende os caracteres representados pelos códigos de caracteres Unicode nos parâmetros.	String
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		indexOf(val:String, startIndex:Number = 0):int Pesquisa a string e retorna a posição da primeira ocorrência de val encontrada em ou após índiceInicial na string de chamada.	String
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		lastIndexOf(val:String, startIndex:Number = 0x7FFFFFFF):int Pesquisa a string da direita para a esquerda e retorna o índice da última ocorrência de val encontrada antes de índiceInicial.	String
		localeCompare(other:String, ... values):int Compara a ordem de classificação de duas ou mais strings e retorna o resultado da comparação como um inteiro.	String
		match(pattern:*):Array Corresponde o padrão especificado com base na string.	String
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		replace(pattern:*, repl:Object):String Corresponde o padrão especificado com base na string e retorna uma nova string na qual a primeira correspondência de padrão é substituída pelo conteúdo especificado por repl.	String
		search(pattern:*):int Procura o padrão especificado e retorna o índice da primeira substring correspondente.	String
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		slice(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String Retorna uma string que inclui o caractere de índiceInicial e todos os caracteres até, mas não incluindo, o caractere de índiceFinal.	String
		split(delimiter:*, limit:Number = 0x7fffffff):Array Divide um objeto String em uma matriz de substrings, dividindo-se sempre que o parâmetro delimitador especificado ocorrer.	String
		substr(startIndex:Number = 0, len:Number = 0x7fffffff):String Retorna uma substring que consiste nos caracteres que começam no índiceInicial especificado e com um comprimento especificado por com.	String
		substring(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String Retorna uma string que consiste no caractere especificado por índiceInicial e todos os caracteres até índiceFinal - 1.	String
		toLocaleLowerCase():String Retorna uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas.	String
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toLocaleUpperCase():String Retorna uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas.	String
		toLowerCase():String Retorna uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas.	String
		toString():String Retorna a representação de string do objeto especificado.	Object
		toUpperCase():String Retorna uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas.	String
		valueOf():String Retorna o valor primitivo da ocorrência de String.	String

Detalhes da propriedade

length

propriedade

length:int [somente leitura]

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Um inteiro que especifica o número de caracteres no objeto String especificado.

Como todos os índices de string são baseados em zero, o índice do último caractere de qualquer string x é x.length - 1.

Implementação
public function get length():int

Detalhes do construtor

()

Construtor

public function String(val:String)

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Cria um novo objeto String inicializado para a string especificada.

Nota: a menos que haja um forte motivo, use literais de string ao invés de objetos String, pois as literais carregam menos o sistema e geralmente são mais fáceis de usar.

Parâmetros

val:String — O valor inicial do novo objeto String.

Detalhes do método

charAt

()

método

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

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna o caractere na posição especificada pelo parâmetro index. Se index não for um número de 0 a string.length - 1, uma string vazia será retornada.

Esse método é semelhante a String.charCodeAt(), exceto pelo fato de que o valor retornado é um caractere e não um código de caractere de inteiro de 16 bits.

Parâmetros

index:Number (default = 0) — Um inteiro que especifica a posição de um caractere na string. O primeiro caractere é indicado por 0 e o último, por my_str.length - 1.

Retorna

String — O caractere no índice especificado. Ou uma string vazia se o índice especificado estiver fora da faixa de índices dessa string.

Elementos da API relacionados

charCodeAt()

charCodeAt

()

método

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

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna o código de caractere Unicode numérico do caractere no index especificado. Se index não for um número de 0 a string.length - 1, NaN será retornado.

Esse método é semelhante a String.charAt(), exceto pelo fato de que o valor retornado é um código de caractere de inteiro de 16 bits e não o número real.

Parâmetros

index:Number (default = 0) — Um inteiro que especifica a posição de um caractere na string. O primeiro caractere é indicado por 0 e o último, por my_str.length - 1.

Retorna

Number — O código de caractere Unicode do caractere no índice especificado. Ou NaN se índice estiver fora da faixa de índices dessa string.

Os valores de Unicode são definidos na especificação do Banco de dados de Caractere de Unicode.

Elementos da API relacionados

charAt()

concat

()

método

AS3 function concat(... args):String

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Acrescenta os argumentos fornecidos ao final do objeto String, convertendo-os em strings se necessário, e retorna a string resultante. O valor original do objeto String de origem permanece inalterado.

Parâmetros

... args — Zero ou mais valores a serem concatenados.

Retorna

String — Uma nova string que consiste nessa string concatenada com os parâmetros especificados.

fromCharCode

()

método

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

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Retorna uma string que compreende os caracteres representados pelos códigos de caracteres Unicode nos parâmetros.

Parâmetros

... charCodes — Uma série de inteiros decimais que representam valores Unicode.

Os valores de Unicode são definidos na especificação do Banco de dados de Caractere de Unicode.

Retorna

String — O valor de string dos códigos de caracteres Unicode especificados.

indexOf

()

método

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

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Pesquisa a string e retorna a posição da primeira ocorrência de val encontrada em ou após startIndex na string de chamada. Esse índice é baseado em zero, significando que o primeiro caractere em uma string é considerado como estando no índice 0 e não no índice 1. Se val não for encontrado, o método retornará -1.

Parâmetros

	`val:String` — A substring para pesquisa.

	`startIndex:Number` (default = `0`) — Um inteiro opcional que especifica o índice inicial da pesquisa.

Retorna

int — O índice da primeira ocorrência da substring especificada ou -1.

Elementos da API relacionados

lastIndexOf()

lastIndexOf

()

método

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

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Pesquisa a string da direita para a esquerda e retorna o índice da última ocorrência de val encontrada antes de startIndex. O índice é baseado em zero, significando que o primeiro caractere está no índice 0 e o último, em string.length - 1. Se val não for encontrado, o método retornará -1.

Parâmetros

	`val:String` — A string para pesquisa.

	`startIndex:Number` (default = `0x7FFFFFFF`) — Um inteiro opcional que especifica o índice inicial a partir do qual procurar `val`. O padrão é o valor máximo permitido para um índice. Se `startIndex` não for especificado, a pesquisa começará no último item da string.

Retorna

int — A posição da última ocorrência da substring especificada ou -1 se não encontrada.

Elementos da API relacionados

indexOf()

localeCompare

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Compara a ordem de classificação de duas ou mais strings e retorna o resultado da comparação como um inteiro. Embora esse método sirva para manipular a comparação de forma específica para cada caso, a implementação ActionScript 3.0 não gera um resultado diferente de outras comparações de string, como os operadores de igualdade (==) ou desigualdade (!=). Se as strings forem equivalentes, o valor de retorno será 0. Se o valor de string original preceder o valor de string especificado por other, o valor de retorno será um inteiro negativo cujo valor absoluto representa o número de caracteres que separa os dois valores de string. Se o valor de string original vier depois de other, o valor de retorno será um inteiro positivo cujo valor absoluto representa o número de caracteres que separa os dois valores de string.

Parâmetros

	`other:String` — Um valor de string a ser comparado.

	`... values` — Conjunto opcional de mais strings a serem comparadas.

Retorna

int — O valor 0 se as strings forem iguais. Caso contrário, um inteiro negativo, se a string original preceder o argumento de string, e um inteiro positivo se o argumento de string preceder a string original. Em ambos os casos, o valor absoluto do número representa a diferença entre as duas strings.

match

()

método

AS3 function match(pattern:*):Array

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Corresponde o pattern especificado com base na string.

Parâmetros

Retorna

Array — Uma matriz de strings que consiste de todas em substrings na string que correspondem ao pattern especificado.

Se pattern for uma expressão regular, para retornar uma matriz com mais de uma string correspondente, o sinalizador g (global) deverá ser definido na expressão regular:

Se o sinalizador g (global) não estiver definido, a matriz de retorno não conterá mais de uma correspondência e a propriedade lastIndex da expressão regular permanecerá inalterada.
Se o sinalizador g (global) estiver definido, o método iniciará a pesquisa no início da string (posição de índice 0). Se uma substring correspondente for uma string vazia (que pode ocorrer com uma expressão regular como /x*/), o método adicionará a string vazia à matriz de correspondências e então continuará a pesquisa na próxima posição de índice. A propriedade lastIndex da expressão regular é definida como 0 depois que o método é concluído.

Quando o parâmetro pattern é uma expressão regular com o sinalizador g (global) definido, o método retorna um Array vazio se nenhuma correspondência for encontrada. Se o parâmetro pattern for uma string ou uma expressão regular não global e nenhuma correspondência for encontrada, o método retorna null. Se você não transmitir um valor (ou transmitir um valor indefinido) como o parâmetro pattern, o método retornará null.

Elementos da API relacionados

RegExp

replace

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Corresponde o pattern especificado com base na string e retorna uma nova string na qual a primeira correspondência de pattern é substituída pelo conteúdo especificado por repl. O parâmetro pattern pode ser uma string ou uma expressão regular. O parâmetro repl pode ser uma string ou uma função; se for uma função, a string retornada pela função é inserida no lugar da correspondência. A string original não é modificada.

No exemplo a seguir, apenas a primeira ocorrência de "sh" (com distinção entre maiúsculas e minúsculas) é substituída:

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

No exemplo a seguir, todas as ocorrências de "sh" (com distinção entre maiúsculas e minúsculas) são substituídas porque o sinalizador g (global) está definido na expressão regular.

    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.

No exemplo a seguir, todas as ocorrências de "sh" são substituídas porque o sinalizador g (global) está definido na expressão regular e as correspondências não fazem distinção entre maiúsculas e minúsculas porque o sinalizador i (ignoreCase) está definido.

    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:* — O padrão a ser correspondido, que pode ser qualquer tipo de objeto, mas que costuma ser uma string ou uma expressão regular. Se você especificar um parâmetro pattern que seja qualquer objeto diferente de uma string ou expressão regular, o método toString() será aplicado ao parâmetro e o método replace() será executado com o uso da string resultante como o pattern.

repl:Object — Em geral, a string inserida no lugar do conteúdo correspondente. Entretanto, você também pode especificar uma função como esse parâmetro. Se você especificar uma função, a string retornada pela função será inserida no lugar do conteúdo correspondente.

Ao especificar uma string como o parâmetro repl e especificar uma expressão regular como o parâmetro pattern, é possível usar os seguintes $ replacement codes especiais na string repl:

$ Code	Texto de substituição
`$$`	`$`
`$&`	A substring correspondida.
$`	A parte da string que precede a substring correspondida. Observe que esse código utiliza o caractere de aspas simples à esquerda (`) e não o caractere de aspas retas simples (') ou o caractere de aspas curvas simples à esquerda (‘).
`$'`	A parte da string que segue a substring correspondida. Observe que esse código usa o caractere de aspas retas simples (').
`$`n	A correspondência de grupo entre parênteses capturado com n, em que n é um dígito simples de 1 a 9 e `$`n não é seguido de um dígito decimal.
`$`nn	A correspondência de grupo entre parênteses capturado com nn, em que nn é um número decimal de dois dígitos (01 a 99). Se a captura nn for indefinida, o texto de substituição será uma string vazia.

Por exemplo, veja a seguir o uso dos códigos de substituição $2 e $1, que representam o primeiro e o segundo grupos de captura correspondidos:

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

Quando você especificar uma função como repl, o método replace() transmitirá os parâmetros a seguir para essa função:

A parte correspondente da string.
As correspondências de grupo entre parênteses capturado são fornecidas nos próximos argumentos. O número de argumentos transmitidos dessa maneira irá variar dependendo do número de correspondências parentéticas. É possível determinar o número de correspondências entre parênteses verificando arguments.length - 3 no código da função.
A posição de índice na string em que a correspondência começa.
A string completa.

Por exemplo, considere o seguinte:

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

A chamada ao método replace() usa uma função como o parâmetro repl. A expressão regular (/([a-z]([0-9]/g) é correspondida duas vezes. Na primeira vez, o padrão corresponde à substring "abc12", e a seguinte lista de argumentos é transmitida à função:

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

Na segunda vez, o padrão corresponde à substring "def23", e a seguinte lista de argumentos é transmitida à função:

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

Retorna

String — A string resultante. Observe que a string de origem permanece inalterada.

Elementos da API relacionados

RegExp

search

()

método

AS3 function search(pattern:*):int

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Procura o pattern especificado e retorna o índice da primeira substring correspondente. Se não houver substring correspondente, o método retornará -1.

Parâmetros

pattern:* — O padrão a ser correspondido, que pode ser qualquer tipo de objeto, mas que costuma ser uma string ou uma expressão regular. Se pattern não for uma expressão regular ou uma string, o método o converterá em uma string antes de executá-lo. Observe que, se você especificar uma expressão regular, o método ignorará o sinalizador global ("g") e a propriedade lastIndex da expressão regular (deixando-a inalterada). Se você transmitir um valor indefinido (ou nenhum valor), o método retornará -1.

Retorna

int — O índice da primeira substring correspondente ou -1 se não houver correspondência. Observe que a string é baseada em zero; o primeiro caractere da string está no índice 0 e o último, em string.length - 1.

Elementos da API relacionados

RegExp

slice

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma string que inclui o caractere de startIndex e todos os caracteres até, mas não incluindo, o caractere de startIndex. O objeto String original não é modificado. Se o parâmetro endIndex não for especificado, o final da substring será também o final da string. Se o caractere indexado por startIndex for igual ou à direita do caractere indexado por endIndex, o método retornará uma string vazia.

Parâmetros

	`startIndex:Number` (default = `0`) — O índice com base em zero do ponto de início da fatia. Se `startIndex` for um número negativo, a fatia será criada da direita para a esquerda, em que -1 é o último caractere.

	`endIndex:Number` (default = `0x7fffffff`) — Um inteiro que é um maior do que o índice do ponto de término da fatia. O caractere indexado pelo parâmetro `endIndex` não é incluído na string extraída. Se `endIndex` for um número negativo, o ponto de término será determinado revertendo-se a contagem a partir do final da string, em que -1 é o último caractere. O padrão é o valor máximo permitido para um índice. Se esse parâmetro for omitido, `String.length` será usado.

Retorna

String — Uma substring com base nos índices especificados.

Elementos da API relacionados

substr()
substring()

split

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Divide um objeto String em uma matriz de substrings, dividindo-se sempre que o parâmetro delimiter especificado ocorrer.

Se o parâmetro delimiter for uma expressão regular, apenas a primeira correspondência em uma determinada posição da string será considerada, mesmo que a operação de retrocesso pudesse localizar uma correspondência de substring não vazia nessa posição. Por exemplo:

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

Se o parâmetro delimiter for uma expressão regular contendo parênteses de agrupamento, sempre que o delimiter for correspondido, os resultados (incluindo qualquer resultado indefinido) desses parênteses de agrupamento serão unidos na matriz de saída. Por exemplo

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

Se o parâmetro limit for especificado, a matriz retornada não terá mais do que o número especificado de elementos.

Se o delimiter for uma string vazia, uma expressão regular vazia ou uma expressão regular que possa corresponder uma string vazia, cada caractere da string será processado como um elemento na matriz.

Se o parâmetro delimiter for indefinido, a string inteira será inserida no primeiro elemento da matriz retornada.

Parâmetros

	`delimiter:*` — O padrão que especifica onde dividir essa string. Pode ser qualquer tipo de objeto, mas costuma ser uma string ou uma expressão regular. Se o `delimiter` não for uma expressão regular ou uma string, o método o converterá em uma string antes de executá-lo.

	`limit:Number` (default = `0x7fffffff`) — O número máximo de itens a ser inclusos na matriz. O padrão é o valor máximo permitido.

Retorna

Array — Uma matriz de substrings.

Elementos da API relacionados

Array.join()
RegExp

substr

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma substring que consiste nos caracteres que começam no startIndex especificado e com um comprimento especificado por com. A string original não é modificada.

Parâmetros

	`startIndex:Number` (default = `0`) — Um inteiro que especificou o índice do primeiro caractere a ser usado para criar a substring. Se `startIndex` for um número negativo, o índice de início será determinado a partir do final da string, em que `-1` é o último caractere.

	`len:Number` (default = `0x7fffffff`) — O número de caracteres na substring que está sendo criada. O valor padrão é o valor máximo permitido. Se `len` não for especificado, a substring incluirá todos os caracteres a partir de `startIndex` até o final da string.

Retorna

String — Uma substring com base nos parâmetros especificados.

substring

()

método

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

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma string que consiste no caractere especificado por startIndex e todos os caracteres até endIndex - 1. Se endIndex não for especificado, String.length será usado. Se o valor de startIndex for igual ao valor de endIndex, o método retornará uma string vazia. Se o valor de startIndex for maior do que o valor de endIndex, os parâmetros serão automaticamente alternados antes que a função seja executada. A string original não é modificada.

Parâmetros

	`startIndex:Number` (default = `0`) — Um inteiro que especificou o índice do primeiro caractere usado para criar a substring. Os valores válidos para `startIndex` são de `0` a `String.length`. Se `startIndex` for um valor negativo, `0` será usado.

	`endIndex:Number` (default = `0x7fffffff`) — Um inteiro que é um maior do que o índice do último caractere na substring extraída. Os valores válidos para `endIndex` são de `0` a `String.length`. O caractere em `endIndex` não são inclusos na substring. O padrão é o valor máximo permitido para um índice. Se esse parâmetro for omitido, `String.length` será usado. Se esse parâmetro for um valor negativo, `0` será usado.

Retorna

String — Uma substring com base nos parâmetros especificados.

toLocaleLowerCase

()

método

AS3 function toLocaleLowerCase():String

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas. A string original não é modificada. Embora este método sirva para manipular a conversão de forma específica para cada caso, a implementação ActionScript 3.0 não gera um resultado diferente do método toLowerCase().

Retorna

String — Uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas.

Elementos da API relacionados

toLowerCase()

toLocaleUpperCase

()

método

AS3 function toLocaleUpperCase():String

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas. A string original não é modificada. Embora este método sirva para manipular a conversão de forma específica para cada caso, a implementação ActionScript 3.0 não gera um resultado diferente do método toUpperCase().

Retorna

String — Uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas.

Elementos da API relacionados

toUpperCase()

toLowerCase

()

método

AS3 function toLowerCase():String

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas. A string original não é modificada.

Esse método converte todos os caracteres (e não simplesmente A-Z) para os quais existem equivalentes Unicode em minúsculas:

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

Estes mapeamentos de caixa são definidos na especificação do Banco de dados de Caractere de Unicode.

Retorna

String — Uma cópia desta string, com todos os caracteres em maiúsculas convertidos em minúsculas.

Elementos da API relacionados

toUpperCase()

toUpperCase

()

método

AS3 function toUpperCase():String

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas. A string original não é modificada.

Este método converte todos os caracteres (e não simplesmente a-z) para os quais existem equivalentes Unicode em maiúsculas:

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

Estes mapeamentos de caixa são definidos na especificação do Banco de dados de Caractere de Unicode.

Retorna

String — Uma cópia desta string, com todos os caracteres em minúsculas convertidos em maiúsculas.

Elementos da API relacionados

toLowerCase()

valueOf

()

método

AS3 function valueOf():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Lite 4, Flash Player 9, AIR 1.0

Retorna o valor primitivo da ocorrência de String. Esse método foi desenvolvido para converter um objeto String em um valor de string primitivo. Como os tempos de execução do Flash chama valueOf() automaticamente quando necessário, raramente você precisará chamar esse método explicitamente.

Retorna

String — O valor da string.

Exemplos Como usar este exemplo

StringExample.as

O exemplo a seguir usa as classes StringExample e StringHelper para mostrar como são usados os vários métodos da classe String. Isso é realizado com as seguintes etapas:

O construtor para StringExample declara várias ocorrências locais de String, que são inicializadas com várias strings e um novo objeto StringHelper.
A classe StringHelper tem os seguintes métodos:
- replace(): chama os métodos split() e join() de String para remover uma substring da string transmitida com uma nova.
- trim(): chama trimBack() e trimFront() usando as strings transmitidas e retorna a string atualizada.
- trimFront(): remove recursivamente todos os caracteres que correspondem ao parâmetro char, começando pela frente da string e seguindo em direção ao fim, até que o primeiro caractere na string não corresponda a char, e retorna a string atualizada.
- trimBack(): remove recursivamente todos os caracteres que correspondem ao parâmetro char, começando pelo fim da string e seguindo em regressão, até que o último caractere na string não corresponda a char, e retorna a string atualizada.
- stringToCharacter(): retorna o primeiro caractere da string a ele transmitida.
Três strings são então geradas com o uso das variáveis de string declaradas, com uma chamada ao método replace() usada para gerar a segunda string e trim() para gerar a terceira string.

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

Aspectos jurídicos | Política de privacidade on-line

String - AS3

Classes x

length

String

charAt

charCodeAt

concat

fromCharCode

indexOf

lastIndexOf

localeCompare

match

replace

search

slice

split

substr

substring

toLocaleLowerCase

toLocaleUpperCase

toLowerCase

toUpperCase

valueOf