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 im zurückgegebenen Substring enthalten sein soll.

length Optional

Die Anzahl der Zeichen, die extrahiert werden sollen.

Rückgabewert

Ein neuer String, der den angegebenen Teil des gegebenen Strings enthält.

Beschreibung

Die substr()-Methode eines Strings extrahiert length Zeichen aus dem String, ausgehend vom start-Index.

• Wenn start >= str.length, wird ein leerer String zurückgegeben.
• Wenn start < 0, beginnt der Index am Ende des Strings zu zählen. Formaler ausgedrückt beginnt der Substring 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() die Zeichen bis zum Ende des Strings.
• Wenn length < 0 ist, wird ein leerer String zurückgegeben.
• Sowohl start als auch length werden, wenn NaN, als 0 behandelt.

Obwohl empfohlen wird, substr() zu vermeiden, gibt es keinen einfachen Weg, substr() in bestehendem Code auf slice() oder substring() zu migrieren, ohne im Wesentlichen ein Polyfill für substr() zu schreiben. Zum Beispiel liefern 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 zurück, während slice() "123" und substring() "0" zurückgeben. Der tatsächliche Umstrukturierungsweg hängt 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-Kompatibilität

Siehe auch

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