CKTIS / JavaScript
String.prototype.substring — een deel van een tekenreeks ophalen
substring() geeft het deel van een tekenreeks tussen start en end terug, waarbij end niet wordt opgenomen. De oorspronkelijke tekenreeks blijft ongewijzigd; indices worden begrensd op de lengte en omgewisseld als de grenzen omgekeerd staan.
Versie: 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 geeft een primitieve tekenreeks terug zonder het origineel te wijzigen. De indices beginnen bij nul: start is inbegrepen en end is uitgesloten. Als end wordt weggelaten of undefined wordt doorgegeven, geldt het einde van de tekenreeks; als start wordt weggelaten, geldt nul.
De argumenten worden naar getallen omgezet en breukdelen worden naar nul afgekapt. NaN en negatieve waarden worden nul; waarden die groter zijn dan de lengte van de tekenreeks worden begrensd op die lengte. Daarna wisselt de methode de grenzen om als start groter is dan end. Gelijke grenzen leveren "" op.
Anders dan bij slice() tellen negatieve indices niet terug vanaf het einde en dwingen omgekeerde grenzen geen leeg resultaat af. De indices verwijzen naar UTF-16-code-eenheden, niet naar volledige zichtbare tekens; het splitsen van een surrogate-paar kan een onvolledig teken opleveren.
Dit is een methode uit de ECMAScript-standaardbibliotheek, geen Web-API. Het voorbeeld laat een bereik, omgewisselde grenzen, een negatieve index, een weggelaten end en een leeg resultaat zien.
Voorbeelden
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)));Resultaat
Script Script Java Script ""
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.