String.prototype.substring()

indexStart

Der Index des ersten Zeichens, das in das zurückgegebene Unterteil eingeschlossen werden soll.

indexEnd Optional

Der Index des ersten Zeichens, das vom zurückgegebenen Unterteil ausgeschlossen werden soll.

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

substring() extrahiert Zeichen von indexStart bis aber nicht einschließlich indexEnd. Insbesondere:

• Wenn indexEnd weggelassen wird, extrahiert substring() Zeichen bis zum Ende des Strings.
• Wenn indexStart gleich indexEnd ist, gibt substring() einen leeren String zurück.
• Wenn indexStart größer als indexEnd ist, wirkt substring() so, als ob die beiden Argumente vertauscht wären; siehe folgendes Beispiel.

Jeder Argumentwert, der kleiner als 0 oder größer als str.length ist, wird behandelt, als wäre er 0 bzw. str.length.

Jeder Argumentwert, der NaN ist, wird behandelt, als wäre er 0.

Das folgende Beispiel verwendet substring(), um Zeichen aus dem String "Mozilla" anzuzeigen:

const anyString = "Mozilla";

console.log(anyString.substring(0, 1)); // "M"
console.log(anyString.substring(1, 0)); // "M"

console.log(anyString.substring(0, 6)); // "Mozill"

console.log(anyString.substring(4)); // "lla"
console.log(anyString.substring(4, 7)); // "lla"
console.log(anyString.substring(7, 4)); // "lla"

console.log(anyString.substring(0, 7)); // "Mozilla"
console.log(anyString.substring(0, 10)); // "Mozilla"

Das folgende Beispiel verwendet die substring()-Methode und die length-Eigenschaft, um die letzten Zeichen eines bestimmten Strings zu extrahieren. Diese Methode ist möglicherweise einfacher zu merken, da Sie die Start- und Endindizes nicht kennen müssen, wie in den obigen Beispielen.

const text = "Mozilla";

// Takes 4 last characters of string
console.log(text.substring(text.length - 4)); // prints "illa"

// Takes 5 last characters of string
console.log(text.substring(text.length - 5)); // prints "zilla"

Es gibt subtile Unterschiede zwischen den Methoden substring() und substr(), daher sollten Sie darauf achten, sie nicht zu verwechseln.

• Die zwei Parameter von substr() sind start und length, während sie bei substring() start und end sind.
• Der start-Index von substr() wird zum Ende des Strings zurückgesetzt, wenn er negativ ist, während substring() ihn auf 0 setzt.
• Negative Längen in substr() werden als null behandelt, während substring() die beiden Indizes vertauscht, wenn end kleiner als start ist.

Darüber hinaus wird substr() als ein veraltetes Feature in ECMAScript betrachtet, daher ist es am besten, seine Verwendung zu vermeiden, wenn möglich.

const text = "Mozilla";
console.log(text.substring(2, 5)); // "zil"
console.log(text.substr(2, 3)); // "zil"

Die Methoden substring() und slice() sind fast identisch, aber es gibt ein paar subtile Unterschiede zwischen den beiden, besonders in der Art und Weise, wie mit negativen Argumenten umgegangen wird.

Die substring()-Methode vertauscht ihre zwei Argumente, wenn indexStart größer als indexEnd ist, was bedeutet, dass trotzdem ein String zurückgegeben wird. Die slice() Methode gibt einen leeren String zurück, wenn das der Fall ist.

const text = "Mozilla";
console.log(text.substring(5, 2)); // "zil"
console.log(text.slice(5, 2)); // ""

Wenn eines oder beide der Argumente negativ oder NaN sind, behandelt die substring()-Methode sie so, als wären sie 0.

console.log(text.substring(-5, 2)); // "Mo"
console.log(text.substring(-5, -2)); // ""

Auch slice() behandelt NaN-Argumente als 0, aber wenn sie negative Werte erhält, zählt sie rückwärts vom Ende des Strings, um die Indizes zu finden.

console.log(text.slice(-5, 2)); // ""
console.log(text.slice(-5, -2)); // "zil"

Siehe die slice()-Seite für weitere Beispiele mit negativen Zahlen.

Das folgende Beispiel ersetzt einen Unterstring innerhalb eines Strings. Es ersetzt sowohl einzelne Zeichen als auch Unterstrings. Der Funktionsaufruf am Ende des Beispiels erstellt einen String Brave New Web aus dem ursprünglichen String Brave New World.

// Replaces oldS with newS in the string fullS
function replaceString(oldS, newS, fullS) {
  for (let i = 0; i < fullS.length; ++i) {
    if (fullS.substring(i, i + oldS.length) === oldS) {
      fullS =
        fullS.substring(0, i) +
        newS +
        fullS.substring(i + oldS.length, fullS.length);
    }
  }
  return fullS;
}

replaceString("World", "Web", "Brave New World");

Beachten Sie, dass dies zu einer Endlosschleife führen kann, wenn oldS selbst ein Unterstring von newS ist — zum Beispiel, wenn Sie versuchen würden, "World" durch "OtherWorld" zu ersetzen.

Eine bessere Methode zum Ersetzen von Strings ist wie folgt:

function replaceString(oldS, newS, fullS) {
  return fullS.split(oldS).join(newS);
}

Der obige Code dient als Beispiel für Unterstring-Operationen. Wenn Sie Unterstrings ersetzen müssen, möchten Sie in den meisten Fällen String.prototype.replace() verwenden.

• String.prototype.substr()
• String.prototype.slice()