substring (String.substring-Methode)

public substring(start:Number, end:Number) : String

Gibt einen String zurück, der alle Zeichen zwischen den Parametern start und end enthält. Wenn der Parameter end nicht angegeben wird, endet der Teilstring am Ende des Strings. Wenn die Werte von start und end identisch sind, gibt die Methode einen leeren String zurück. Wenn der Wert von start größer ist als der Wert von end, werden die Parameter vor Ausführung der Funktion automatisch ausgetauscht. Der ursprüngliche Wert wird nicht geändert.

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. Gültige Werte für start sind 0 bis String.length - 1. Wenn start ein negativer Wert ist, wird der Wert 0 verwendet.

end:Number - Eine Ganzzahl, die 1 + den Index des letzten zu extrahierenden Zeichens in my_str angibt. Gültige Werte für end sind 1 bis String.length. Das durch den Parameter end indizierte Zeichen wird nicht in den extrahierten String aufgenommen. Wenn Sie diesen Parameter weglassen, wird String.length verwendet. Wenn dieser Parameter ein negativer Wert ist, wird 0 verwendet.

Rückgabewerte

String - Ein Teilstring eines angegebenen Strings.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung von substring():

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(6,11);
trace(mySubstring); // Ausgabe: world

Im folgenden Beispiel wird die Verwendung eines negativen start-Parameters veranschaulicht:

var my_str:String = "Hello world";
var mySubstring:String = my_str.substring(-5,5);
trace(mySubstring); // Ausgabe: Hello

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