String.prototype.substring()

indexStart

Der Index des ersten Zeichens, das im zurückgegebenen Teilstring enthalten sein soll.

indexEnd Optional

Der Index des ersten Zeichens, das im zurückgegebenen Teilstring 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 oder undefined ist, 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 wären die beiden Argumente vertauscht; siehe Beispiel unten.

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 so 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 lässt sich einfacher merken, da Sie nicht die Start- und Endindizes 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 beiden Parameter von substr() sind start und length, während sie bei substring() start und end sind.
• Der start-Index von substr() wird um das Ende des Strings gewickelt, wenn er negativ ist, während substring() ihn auf 0 begrenzt.
• Negative Längen bei substr() werden als Null behandelt, während substring() die beiden Indizes vertauschen wird, wenn end kleiner als start ist.

Darüber hinaus wird substr() als ein veraltetes Feature in ECMAScript betrachtet, daher sollte es nach Möglichkeit vermieden werden.

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 einige subtile Unterschiede, insbesondere in der Behandlung negativer Argumente.

Die Methode substring() tauscht ihre beiden Argumente, wenn indexStart größer als indexEnd ist, was bedeutet, dass dennoch ein String zurückgegeben wird. Die Methode slice() gibt in diesem Fall einen leeren String zurück.

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

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

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

slice() behandelt auch NaN-Argumente als 0, zählt jedoch bei negativen Werten 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"

Weitere Beispiele mit negativen Zahlen finden Sie auf der Seite slice().

Das folgende Beispiel ersetzt einen Teilstring innerhalb eines Strings. Es wird sowohl einzelne Zeichen als auch Teilstrings ersetzen. 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 Teilstring von newS ist — z.B. 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 Teilstring-Operationen. Wenn Sie Teilstrings ersetzen müssen, werden Sie in den meisten Fällen String.prototype.replace() verwenden wollen.

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