CKTIS / JavaScript
String.prototype.substring — získání části řetězce
substring() vrací část řetězce mezi indexy start a end, přičemž end nezahrnuje. Původní řetězec nemění, indexy omezuje na jeho délku a při obráceném pořadí hranice prohodí.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.substring(start, end)String.prototype.substring vrací primitivní řetězec, aniž by změnila původní řetězec. Indexy začínají od nuly: start se zahrnuje, end nikoli. Pokud end vynecháte nebo předáte undefined, použije se konec řetězce; při vynechání start se použije nula.
Argumenty se převádějí na čísla a jejich desetinné části se oříznou směrem k nule. NaN a záporné hodnoty se změní na nulu; hodnoty větší než délka řetězce se omezí na tuto délku. Metoda pak prohodí hranice, pokud je start větší než end. Stejné hranice vrátí "".
Na rozdíl od slice() záporné indexy nepočítají zpět od konce a obrácené hranice nevynutí prázdný výsledek. Indexy označují jednotky kódu UTF-16, nikoli celé viditelné znaky; rozdělení páru surrogátů může vrátit neúplný znak.
Jde o metodu standardní knihovny ECMAScript, nikoli o Web API. Příklad ukazuje rozsah, prohozené hranice, záporný index, vynechané end a prázdný výsledek.
Příklady
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)));Výsledek
Script Script Java Script ""
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.