String  - AS3

Un numero intero che specifica il numero di caratteri presenti nell'oggetto String specificato.

Dal momento che tutti gli indici di stringa sono a base zero, l'indice dell'ultimo carattere di una qualunque stringa x è x.length -1.

Altri esempi

Crea un nuovo oggetto String inizialmente impostato sulla stringa specificata.

Nota: dal momento che i caratteri letterali di stringa utilizzano meno risorse rispetto agli oggetti String e generalmente sono più facili da utilizzare, è consigliabile utilizzarli al posto della classe String, se non è strettamente necessario utilizzare un oggetto String.

Altri esempi

Restituisce il carattere nella posizione specificata dal parametro index. Se index non è un numero compreso tra 0 e string.length -1, viene restituita una stringa vuota.

Questo metodo è simile a String.charCodeAt() a eccezione del fatto che il valore restituito è un carattere e non un codice di carattere intero a 16 bit.

Parametri

Altri esempi

Elementi API correlati

Restituisce il codice del carattere Unicode numerico per il carattere che si trova nella posizione index specificata. Se index non è un numero compreso tra 0 e string.length - 1, viene restituito NaN.

Questo metodo è simile a String.charAt() a eccezione del fatto che il valore restituito è un codice di carattere intero a 16 bit e non il carattere vero e proprio.

Parametri

Altri esempi

Elementi API correlati

Aggiunge gli argomenti forniti alla fine dell'oggetto String, convertendoli in stringhe se necessario, e restituisce la stringa risultante. Il valore originale dell'oggetto String di origine rimane invariato.

Parametri

Altri esempi

Restituisce una stringa che comprende i caratteri rappresentati dai codici dei caratteri Unicode presenti nei parametri.

Parametri

Altri esempi

Cerca la stringa e restituisce la posizione della prima occorrenza di val trovata in corrispondenza o dopo startIndex all'interno della stringa chiamante. Questo indice è a base zero, pertanto l'indice 0 (e non l'indice 1) viene considerato come posizione del primo carattere di una stringa. Se val non viene trovato, il metodo restituisce -1.

Parametri

Altri esempi

Elementi API correlati

Cerca la stringa da destra a sinistra e restituisce l'indice dell'ultima occorrenza di val trovata prima di startIndex. Questo indice è a base zero, pertanto l'indice 0 viene considerato come posizione del primo carattere, mentre la posizione dell'ultimo carattere è string.length - 1. Se val non viene trovato, il metodo restituisce -1.

Parametri

Altri esempi

Elementi API correlati

Confronta il tipo di ordinamento di due o più stringhe e restituisce il risultato del confronto sotto forma di un numero intero. Mentre questo metodo è progettato per gestire il confronto in modo specifico per le singole versioni localizzate, l'implementazione ActionScript 3.0 non produce un risultato diverso rispetto ad altri confronti di stringa, quali gli operatori di uguaglianza (==) o di disuguaglianza (!=). Se le stringhe sono equivalenti, il valore restituito è 0. Se il valore di stringa originale precede il valore di stringa specificato da other, il valore restituito è un numero intero negativo, il valore assoluto del quale rappresenta il numero di caratteri che separano i due valori di stringa. Se il valore di stringa originale viene dopo il valore di stringa specificato da other, il valore restituito è un numero intero positivo, il valore assoluto del quale rappresenta il numero di caratteri che separano i due valori di stringa.

Parametri

Cerca la corrispondenza del parametro pattern specificato rispetto alla stringa.

Parametri

Altri esempi

Elementi API correlati

Cerca la corrispondenza del parametro pattern specificato rispetto alla stringa e restituisce una nuova stringa in cui la prima corrispondenza di pattern viene sostituita con il contenuto specificato da repl. Il parametro pattern può essere una stringa o un'espressione regolare. Il parametro repl può essere una stringa o una funzione; se è una funzione, la stringa restituita dalla funzione viene inserita al posto della corrispondenza. La stringa originale non viene modificata.

Nell'esempio seguente, viene sostituita solo la prima istanza di "sh" (sensibile alle maiuscole e minuscole):

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

Nell'esempio seguente, vengono sostituite tutte le istanze di "sh" (sensibile alle maiuscole e minuscole) perché nell'espressione regolare è impostato il flag g (global):

    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.

Nell'esempio seguente, vengono sostituite tutte le istanze di "sh" perché nell'espressione regolare è impostato il flag g (global), e le corrispondenze non sono sensibili alle maiuscole e minuscole perché è impostato il flag 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.

Parametri

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

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

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

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

Altri esempi

Elementi API correlati

Cerca il parametro pattern specificato e restituisce l'indice della prima sottostringa corrispondente. Se non viene trovata alcuna sottostringa corrispondente, il metodo restituisce -1.

Parametri

Altri esempi

Elementi API correlati

Restituisce una stringa che comprende il carattere startIndex e tutti i caratteri fino a endIndex escluso. L'oggetto String originale non viene modificato. Se il parametro endIndex non viene specificato, la fine della sottostringa coincide con la fine della stringa. Se il carattere con indice startIndex è lo stesso o si trova a destra del carattere con indice endIndex, il metodo restituisce una stringa vuota.

Parametri

Altri esempi

Elementi API correlati

Suddivide un oggetto String in un array di sottostringhe in corrispondenza di ogni parametro delimiter.

Se il parametro delimiter è un'espressione regolare, viene considerata solo la prima corrispondenza in una data posizione della stringa, anche se il backtracking fosse in grado di trovare una corrispondenza di sottostringa non vuota in quella posizione. Ad esempio:

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

Se il parametro delimiter è un'espressione regolare che contiene delle parentesi di raggruppamento, ogni volta che viene trovata una corrispondenza di delimiter i risultati (compresi quelli eventualmente undefined) delle parentesi di raggruppamento vengono suddivisi nell'array di output. Ad esempio

     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 il parametro limit è specificato, l'array restituito ha al massimo il numero specificato di elementi.

Se delimiter è una stringa vuota, un'espressione regolare vuota o un'espressione regolare che può corrispondere a una stringa vuota, ogni singolo carattere nella stringa viene restituito come elemento dell'array.

Se il parametro delimiter non è definito, l'intera stringa viene collocata nel primo elemento dell'array restituito.

Parametri

Altri esempi

Elementi API correlati

Restituisce una sottostringa costituita dai caratteri che iniziano in corrispondenza del parametro startIndex specificato e la cui lunghezza è specificata da len. La stringa originale è invariata.

Parametri

Altri esempi

Restituisce una stringa costituita dal carattere specificato da startIndex e tutti i caratteri fino a endIndex -1. Se endIndex non è specificato, viene utilizzato String.length. Se il valore di startIndex è uguale a quello di endIndex, il metodo restituisce una stringa vuota. Se il valore di startIndex è maggiore di quello di endIndex, i parametri vengono automaticamente scambiati prima che la funzione venga eseguita La stringa originale è invariata.

Parametri

Altri esempi

Restituisce una copia di questa stringa, convertendo tutti i caratteri maiuscoli in minuscoli. La stringa originale è invariata. Mentre questo metodo è progettato per gestire la conversione in modo specifico per le singole versioni localizzate, l'implementazione ActionScript 3.0 non produce un risultato diverso rispetto al metodo toLowerCase().

Elementi API correlati

Restituisce una copia di questa stringa, convertendo tutti i caratteri minuscoli in maiuscoli. La stringa originale è invariata. Mentre questo metodo è progettato per gestire la conversione in modo specifico per le singole versioni localizzate, l'implementazione ActionScript 3.0 non produce un risultato diverso rispetto al metodo toUpperCase().

Elementi API correlati

Restituisce una copia di questa stringa, convertendo tutti i caratteri maiuscoli in minuscoli. La stringa originale è invariata.

Questo metodo converte tutti i caratteri (non solo da A a Z) per cui esistono degli equivalenti Unicode minuscoli:

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

Queste mappature tra maiuscole e minuscole sono definite nella specifica Unicode Character Database.

Altri esempi

Elementi API correlati

Restituisce una copia di questa stringa, convertendo tutti i caratteri minuscoli in maiuscoli. La stringa originale è invariata.

Questo metodo converte tutti i caratteri (non solo a-z) per cui esistono degli equivalenti Unicode maiuscoli:

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

Queste mappature tra maiuscole e minuscole sono definite nella specifica Unicode Character Database.

Altri esempi

Elementi API correlati

Restituisce il valore di base di un'istanza String. Questo metodo è progettato per convertire un oggetto String in un valore di stringa di base. Dal momento che i runtime Flash chiamano automaticamente valueOf() quando necessario, è raro che sia necessario chiamare esplicitamente questo metodo.

1. La funzione di costruzione per la classe StringExample dichiara diverse istanze String locali che vengono inizializzate con diverse stringhe e un nuovo oggetto StringHelper.
2. La classe StringHelper utilizza i seguenti metodi:
   • replace(): chiama i metodi split() e join() di String per rimuovere una sottostringa della stringa passata e sostituirla con una nuova.
   • trim(): chiama trimBack() e trimFront() utilizzando le stringhe passate e restituisce la stringa aggiornata.
   • trimFront():sostituisce in modo ricorsivo tutti i caratteri che corrispondono al parametro char, a partire dall'inizio della stringa verso la fine, fino a che l'ultimo carattere della stringa non corrisponde a char e restituisce la stringa aggiornata.
   • trimBack(): sostituisce in modo ricorsivo tutti i caratteri che corrispondono al parametro char, a ritroso a partire dalla fine della stringa, fino a che l'ultimo carattere della stringa non corrisponde a char e restituisce la stringa aggiornata.
   • stringToCharacter(): restituisce il primo carattere della stringa passata.
3. Vengono quindi prodotte tre stringhe utilizzando le variabili di stringa dichiarate con una chiamata al metodo replace() utilizzato per produrre la seconda stringa e trim() per produrre la terza stringa.

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