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 vom zurückgegebenen Teilstring ausgeschlossen wird.

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 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 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 leichter zu merken, da Sie die Start- und Endindices 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 feine Unterschiede zwischen den Methoden substring() und substr(), daher sollten Sie aufpassen, 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 an das Ende des Strings exportiert, wenn er negativ ist, während substring() ihn auf 0 beschränkt.
• 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 Legacy-Funktion in ECMAScript betrachtet, daher sollte die Verwendung 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, es gibt jedoch ein paar subtile Unterschiede zwischen den beiden, besonders in der Art und Weise, wie negative Argumente behandelt werden.

Die substring()-Methode vertauscht ihre beiden Argumente, wenn indexStart größer als indexEnd ist, was bedeutet, dass dennoch ein String zurückgegeben wird. Die slice() Methode 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 substring()-Methode sie, als ob sie 0 wären.

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

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

Sehen Sie sich die Seite slice() für weitere Beispiele mit negativen Zahlen an.

Das folgende Beispiel ersetzt einen Teilstring innerhalb eines Strings. Es ersetzt sowohl einzelne Zeichen als auch Teilstrings. 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 — zum Beispiel, wenn Sie versuchen würden, "World" mit "OtherWorld" zu ersetzen.

Eine bessere Methode zum Ersetzen von Strings ist die folgende:

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

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

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