String.prototype.substring()

Definition

Die substring() Methode gibt einen Teilstring eines Strings zwischen einem Index und einem anderen, oder dem Ende der Zeichenkette zurück.

Syntax

str.substring(indexA[, indexB])

Parameter

indexA

Ein Integer zwischen 0 und der Länge der Zeichenkette, welcher das erste Zeichen des Teilstrings repräsentiert.

indexB

Optional. Ein Integer zwischen 0 und der Länge der Zeichenkette, welcher das erste nicht im Teilstring enthaltene Zeichen darstellt.

Beschreibung

substring() extrahiert Zeichen von indexA bis nicht einschließlich indexB. Im Detail:

• Falls indexA gleich indexB ist, gibt substring() einen leeren String zurück.
• Falls indexB nicht angegeben ist, extrahiert substring() alle Zeichen bis zum Ende der Zeichenkette.
• Falls eines der Argumente kleiner als 0 oder NaN ist, wird dieser als 0 interpretiert.
• Falls eines der Argumente größer als die Länge der Zeichenkette ist, wird dieses als stringName.length behandelt.

Falls indexA größer als indexB ist, werden die Argumente vertauscht substring(); zum Beispiel, str.substring(1, 0) == str.substring(0, 1).

Beispiele

Beispiel: Benutzung von substring()

Das folgende Beispiel benutzt substring() um Zeichen des Strings 'Mozilla' anzuzeigen:

var anyString = 'Mozilla';

// Zeigt 'Moz'
console.log(anyString.substring(0, 3));
console.log(anyString.substring(3, 0));

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

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

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

Beispiel: Benutzung von substring() mit length Eigenschaft

Das folgende Beispiel benutzt die substring() Methode und die length Eigenschaft um die letzten Zeichen des Strings zu extrahieren. Dieser Anwendungfall ist einfacher zu merken, da der genaue Start- und Endparameter nicht bekannt sein müssen.

// Zeigt 'illa' - die letzten 4 Zeichen
var anyString = 'Mozilla';
var anyString4 = anyString.substring(anyString.length - 4);
console.log(anyString4);

// Zeigt 'zilla' - die letzten 5 Zeichen
var anyString = 'Mozilla';
var anyString5 = anyString.substring(anyString.length - 5);
console.log(anyString5);

Beispiel: Ersetze ein Teilstring mit einem String

Das folgende Beispiel ersetzt ein Teilstring mit einem String. Es werden beide individuellen Zeiche und Teilstrings ersetzt. Der Funktionsaufruf am Ende des Beispiel ändert die Zeichenkette 'Brave New World' in 'Brave New Web'.

// Ersetzt oldS mit newS in der Zeichenkette fullS
function replaceString(oldS, newS, fullS) {
  for (var 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');

Beachte, dass mit diesem Beispiel auch in einer Endlosschleife erzeugt werden kann, wenn oldS ein Teilstring von newS ist — zum Beispiel, falls 'World' mit 'OtherWorld' ersetzt wird. Der folgende Code zeigt ein bessere Methode Strings zu ersetzen:

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

Der oben stehende Code zeigt ein Beispiel für die Verwendung der substring Operation. Falls Teilstringe ersetzt werden, kann in den meisten Fällen String.prototype.replace() verwendet werden.

Specifizationen

Browser Kompatibilität

Siehe auch

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