Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri