CKTIS / JavaScript
String.prototype.split — razdelitev besedila v polje
String.prototype.split razdeli besedilo glede na ločilo in vrne polje delov. Spoznajte delovanje omejitve in praznih elementov ter razliko med praznim in izpuščenim ločilom.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
string.split(separator, limit)String.prototype.split razdeli besedilo od leve proti desni, ne da bi spremenil izvirnik. Ločilo v obliki niza se ujema dobesedno in ni vključeno v dobljeno polje. Sosednja ločila ter ločila na začetku ali koncu lahko ustvarijo prazne elemente.
Če je separator izpuščen ali ima vrednost undefined, metoda vrne polje s celotnim nizom, razen če je omejitev enaka nič. Če ni ujemanja, prav tako ostane celoten niz nespremenjen. Ločilo "" razdeli niz na kodne enote UTF-16, ki ne ustrezajo vedno celotnim znakom, kot jih zaznava uporabnik; "".split("") vrne [].
Izbirni argument limit omeji število elementov, ne števila delitev: preostalo besedilo se zavrže. Privzeta vrednost je 2 ** 32 - 1; podana vrednost se pretvori z ToUint32. Vrednost limit enaka 0 da rezultat [].
Ločilo je lahko tudi objekt z metodo [Symbol.split], na primer RegExp. V tem primeru split tej metodi posreduje sprejemnik in omejitev ter neposredno vrne njen rezultat; metoda po meri lahko spremeni zgoraj opisana pravila. Klic String.prototype.split s sprejemnikom null ali undefined sproži TypeError.
Primeri
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("")));Rezultat
["red","","blue",""] ["red",""] ["red,,blue,"] []
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.