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 der zurückgegebenen Teilzeichenfolge enthalten sein soll.

length Optional

Die Anzahl der zu extrahierenden Zeichen.

Rückgabewert

Eine neue Zeichenfolge, die den angegebenen Teil der ursprünglichen Zeichenfolge enthält.

Beschreibung

Die Methode substr() einer Zeichenfolge extrahiert length Zeichen ab dem Index start.

• Wenn start >= str.length gilt, wird eine leere Zeichenfolge zurückgegeben.
• Wenn start < 0 gilt, wird der Index vom Ende der Zeichenfolge aus gezählt. Genauer gesagt beginnt die Teilzeichenfolge in diesem Fall bei max(start + str.length, 0).
• Wenn start weggelassen wird oder undefined ist, wird der Wert als 0 behandelt.
• Wenn length weggelassen wird oder undefined ist oder wenn start + length >= str.length gilt, extrahiert substr() die Zeichen bis zum Ende der Zeichenfolge.
• Wenn length < 0 gilt, wird eine leere Zeichenfolge zurückgegeben.
• Sowohl für start als auch für length wird NaN als 0 behandelt.

Obwohl Sie substr() möglichst nicht verwenden sollten, gibt es keine einfache Möglichkeit, die Verwendung von substr() in bestehendem Code durch slice() oder substring() zu ersetzen, ohne im Wesentlichen einen Polyfill für substr() zu schreiben. Beispielsweise liefern str.substr(a, l), str.slice(a, a + l) und str.substring(a, a + l) bei str = "01234", a = 1, l = -2 unterschiedliche Ergebnisse: substr() gibt eine leere Zeichenfolge zurück, slice() gibt "123" zurück und substring() gibt "0" zurück. Wie der Code tatsächlich umgestellt werden kann, hängt vom möglichen Wertebereich von a und l ab.

Beispiele

substr() verwenden

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-Kompatibilität

Siehe auch

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