CKTIS / JavaScript
String.prototype.substring — einen Teil einer Zeichenfolge extrahieren
substring() gibt den Teil einer Zeichenfolge zwischen start und end zurück, wobei end nicht eingeschlossen ist. Die ursprüngliche Zeichenfolge bleibt unverändert; Indizes werden auf ihre Länge begrenzt und bei umgekehrter Reihenfolge vertauscht.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
str.substring(start, end)String.prototype.substring gibt eine primitive Zeichenfolge zurück, ohne das Original zu ändern. Die Indizes beginnen bei null: start ist eingeschlossen, end nicht. Wird end weggelassen oder undefined übergeben, gilt das Ende der Zeichenfolge; wird start weggelassen, gilt null.
Die Argumente werden in Zahlen umgewandelt, wobei Nachkommastellen gegen null abgeschnitten werden. NaN und negative Werte werden zu null; Werte über der Länge der Zeichenfolge werden auf diese Länge begrenzt. Anschließend vertauscht die Methode die Grenzen, wenn start größer als end ist. Gleiche Grenzen ergeben "".
Anders als bei slice() zählen negative Indizes nicht vom Ende rückwärts, und umgekehrte Grenzen erzwingen kein leeres Ergebnis. Indizes beziehen sich auf UTF-16-Codeeinheiten, nicht auf vollständige sichtbare Zeichen; wird ein Surrogatpaar getrennt, kann ein unvollständiges Zeichen zurückgegeben werden.
Dies ist eine Methode der ECMAScript-Standardbibliothek und keine Web-API. Das Beispiel zeigt einen Bereich, vertauschte Grenzen, einen negativen Index, ein weggelassenes end und ein leeres Ergebnis.
Beispiele
const text = "JavaScript";
console.log(text.substring(4, 10));
console.log(text.substring(10, 4));
console.log(text.substring(-3, 4));
console.log(text.substring(4));
console.log(JSON.stringify(text.substring(4, 4)));Ergebnis
Script Script Java Script ""
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.