CKTIS / JavaScript
String.prototype.split — rozdelenie textu na pole
String.prototype.split rozdelí text podľa oddeľovača a vráti pole častí. Zistite, ako funguje limit a prázdne prvky a aký je rozdiel medzi prázdnym a vynechaným oddeľovačom.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.split(separator, limit)String.prototype.split rozdeľuje text zľava doprava a nemení pôvodný reťazec. Oddeľovač v podobe reťazca sa hľadá doslovne a do výsledného poľa sa nezahŕňa. Susedné oddeľovače aj oddeľovače na začiatku alebo na konci môžu vytvoriť prázdne prvky.
Ak je separator vynechaný alebo má hodnotu undefined, metóda vráti pole obsahujúce celý reťazec, pokiaľ limit nie je nula. Ak sa nenájde žiadna zhoda, zostane zachovaný celý reťazec. Oddeľovač "" rozdeľuje na jednotky kódu UTF-16, ktoré nemusia zodpovedať celým znakom vnímaným používateľom; "".split("") vráti [].
Nepovinný argument limit obmedzuje počet prvkov, nie počet rozdelení: zvyšný text sa zahodí. Predvolená hodnota je 2 ** 32 - 1; zadaná hodnota sa prevedie pomocou ToUint32. Hodnota limit rovná 0 vytvorí [].
Oddeľovačom môže byť aj objekt s metódou [Symbol.split], napríklad RegExp. V takom prípade odovzdá split tejto metóde prijímateľa a limit a jej výsledok vráti priamo; vlastná metóda môže vyššie opísané pravidlá zmeniť. Volanie String.prototype.split s prijímateľom null alebo undefined vyvolá TypeError.
Príklady
const text = "red,,blue,";
console.log(JSON.stringify(text.split(",")));
console.log(JSON.stringify(text.split(",", 2)));
console.log(JSON.stringify(text.split()));
console.log(JSON.stringify("".split("")));Výsledok
["red","","blue",""] ["red",""] ["red,,blue,"] []
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.