slice (String.slice-Methode)

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

Gibt einen String zurück, der das durch start angegebene Zeichen und alle Zeichen bis zu dem durch end angegebenen Zeichen (jedoch nicht einschließlich) enthält. Das ursprüngliche String-Objekt wird nicht geändert. Wenn der Parameter end nicht angegeben wird, endet der Teilstring am Ende des Strings. Wenn das durch start indizierte Zeichen mit dem durch end indizierten Zeichen übereinstimmt oder rechts von diesem liegt, gibt die Methode einen leeren String zurück.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

start:Number - Der Index mit der Basis Null des Segmentanfangs. Wenn start negativ ist, wird der Anfangspunkt ausgehend vom Ende des Strings ermittelt, wobei -1 das letzte Zeichen des Strings ist.

end:Number - Eine Ganzzahl, die 1 + den Index des Segmentendes angibt. Das durch den Parameter end indizierte Zeichen wird nicht in den extrahierten String aufgenommen. Wenn Sie diesen Parameter weglassen, wird String.length verwendet. Wenn end negativ ist, wird der Endpunkt ausgehend vom Ende des Strings ermittelt, wobei -1 das letzte Zeichen des Strings ist.

Rückgabewerte

String - Ein Teilstring eines angegebenen Strings.

Beispiel

Im folgenden Beispiel wird die Variable my_str erstellt, ihr ein Stringwert zugewiesen und anschließend die Methode slice() mit zahlreichen Werten für die Parameter start und end aufgerufen. Jeder Aufruf von slice() ist in eine trace()-Anweisung eingeschlossen, die die Ausgabe im Bedienfeld Ausgabe anzeigt.

// Indexwerte für das Stringliteral
// positive Indexwerte: 0 1 2 3 4
// String: L o r e m
// negative Indexwerte: -5 -4 -3 -2 -1

var my_str:String = "Lorem";

// erstes Zeichen ausschneiden
trace("slice(0,1): "+my_str.slice(0, 1)); // Ausgabe: slice(0,1): L
trace("slice(-5,1): "+my_str.slice(-5, 1)); // Ausgabe: slice(-5,1): L

// mittlere drei Zeichen ausschneiden
trace("slice(1,4): "+my_str.slice(1, 4)); // slice(1,4): ore
trace("slice(1,-1): "+my_str.slice(1, -1)); // slice(1,-1): ore

// Stringausschnitte, die leere Strings zurückgeben, da der Startwert nicht kleiner als der Endwert ist
trace("slice(1,1): "+my_str.slice(1, 1)); // slice(1,1):
trace("slice(3,2): "+my_str.slice(3, 2)); // slice(3,2):
trace("slice(-2,2): "+my_str.slice(-2, 2)); // slice(-2,2):

// bei Ausschnitten ohne end-Parameter wird "String.length" verwendet, im Beispiel: 5
trace("slice(0): "+my_str.slice(0)); // slice(0): Lorem
trace("slice(3): "+my_str.slice(3)); // slice(3): em

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

Siehe auch

substr (String.substr-Methode), substring (String.substring-Methode)