substr (String.substr-Methode)

public substr(start:Number, length:Number) : String

Gibt die Zeichen in einem String ab dem durch den Parameter start angegebenen Index bis zu der im Parameter length angegebenen Anzahl von Zeichen zurück. Die Methode substr ändert den in my_str angegebenen String nicht, sondern gibt einen neuen String zurück.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

start:Number - Eine Ganzzahl, die die Position des ersten Zeichens in my_str angibt, das in den Teilstring aufgenommen werden soll. Wenn start negativ ist, wird der Anfangspunkt ausgehend vom Ende des Strings ermittelt, wobei -1 das letzte Zeichen des Strings ist.

length:Number - Die Anzahl der in den Teilstring aufzunehmenden Zeichen. Wenn length nicht angegeben wird, enthält der Teilstring alle Zeichen vom Anfang bis zum Ende des Strings.

Rückgabewerte

String - Ein Teilstring eines angegebenen Strings.

Beispiel

Im folgenden Beispiel wird der neue String my_str erstellt und mit substr() das zweite Wort im String zurückgegeben. Dabei wird zuerst ein positiver start-Parameter und dann ein negativer start-Parameter verwendet.

var my_str:String = new String("Hello world");
var mySubstring:String = new String();
mySubstring = my_str.substr(6,5);
trace(mySubstring); // Ausgabe: world

mySubstring = my_str.substr(-5,5);
trace(mySubstring); // Ausgabe: world

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