split (String.split-Methode)

public split(delimiter:String, [limit:Number]) : Array

Trennt ein String-Objekt bei jedem Vorkommen von delimiter und gibt die dabei entstandenen Teilstrings in einem Array zurück. Wenn als Trennzeichen ein leerer String ("") angegeben wird, wird jedes Zeichen im String als Element in das Array aufgenommen.

Wenn der Parameter delimiter nicht definiert ist, wird der gesamte String in das erste Element des zurückgegebenen Arrays gesetzt.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

delimiter:String - Ein String. Das Zeichen oder der String, an dem my_str getrennt wird.

limit:Number [optional] - Die Anzahl der Elemente, die in das Array platziert werden sollen.

Rückgabewerte

Array - Ein Array mit den Teilstrings von my_str.

Beispiel

Im folgenden Beispiel wird ein Array mit fünf Elementen zurückgegeben:

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// Ausgabe:
    P
    A
    T
    S
    Y

Im folgenden Beispiel wird ein Array mit zwei Elementen ("P" und "A") zurückgegeben:

var my_str:String = "P,A,T,S,Y";
var my_array:Array = my_str.split(",", 2);
trace(my_array); // Ausgabe: P,A

Im folgenden Beispiel wird veranschaulicht, dass bei Angabe eines leeren Strings ("") für den Parameter delimiter jedes Zeichen im String als Element in das Array aufgenommen wird.

var my_str:String = new String("Joe");
var my_array:Array = my_str.split("");
for (var i = 0; i<my_array.length; i++) {
    trace(my_array[i]);
}
// Ausgabe:
    J
    o
    e

Ein weiteres Beispiel finden Sie in der Datei Strings.fla im Ordner mit ActionScript-Beispielen. Die Standardpfade lauten:

Siehe auch

join (Array.join-Methode)