String.prototype.substr()

Probieren Sie es aus

const str = "Mozilla";

console.log(str.substr(1, 2));
// Expected output: "oz"

console.log(str.substr(2));
// Expected output: "zilla"

Syntax

substr(start)
substr(start, length)

Parameter

start

Der Index des ersten Zeichens, das in die zurckgegebene Teilzeichenkette aufgenommen werden soll.

length Optional

Die Anzahl der zu extrahierenden Zeichen.

Rckgabewert

Ein neuer String, der den angegebenen Teil des gegebenen Strings enthlt.

Beschreibung

Die substr() Methode eines Strings extrahiert length Zeichen aus dem String, beginnend beim start Index.

• Wenn start >= str.length, wird ein leerer String zurckgegeben.
• Wenn start < 0, beginnt der Index von hinten im String zu zhlen. Genauer gesagt, beginnt die Teilzeichenkette in diesem Fall bei max(start + str.length, 0).
• Wenn start weggelassen wird oder undefined ist, wird es als 0 behandelt.
• Wenn length weggelassen wird oder undefined ist, oder wenn start + length >= str.length, extrahiert substr() Zeichen bis zum Ende des Strings.
• Wenn length < 0, wird ein leerer String zurckgegeben.
• Sowohl fr start als auch fr length wird NaN als 0 behandelt.

Obwohl empfohlen wird, substr() zu vermeiden, gibt es keinen trivialen Weg, substr() in alten Code auf slice() oder substring() zu migrieren, ohne im Wesentlichen ein Polyfill fr substr() zu erstellen. Zum Beispiel haben str.substr(a, l), str.slice(a, a + l), und str.substring(a, a + l) alle unterschiedliche Ergebnisse, wenn str = "01234", a = 1, l = -2 substr() gibt einen leeren String zurck, slice() gibt "123" zurck, whrend substring() "0" zurckgibt. Der tatschliche Refactoring-Pfad hngt vom Wissen ber den Bereich von a und l ab.

Beispiele

Verwendung von substr()

const string = "Mozilla";

console.log(string.substr(0, 1)); // 'M'
console.log(string.substr(1, 0)); // ''
console.log(string.substr(-1, 1)); // 'a'
console.log(string.substr(1, -1)); // ''
console.log(string.substr(-3)); // 'lla'
console.log(string.substr(1)); // 'ozilla'
console.log(string.substr(-20, 2)); // 'Mo'
console.log(string.substr(20, 2)); // ''

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von String.prototype.substr in core-js
• es-shims Polyfill von String.prototype.substr
• String.prototype.slice()
• String.prototype.substring()