Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje