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

CKTIS / JavaScript

String.prototype.charCodeAt — vrednost kodne enote UTF-16

Metoda charCodeAt vrne številsko vrednost kodne enote UTF-16 na danem indeksu ali NaN, če je indeks zunaj niza. Ne vrne vedno celotne kodne točke Unicode.

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.charCodeAt(index)

String.prototype.charCodeAt prebere eno kodno enoto UTF-16. Indeksi se začnejo pri 0. Če je indeks v veljavnem obsegu, je rezultat Number od 0 do 65535. Metoda niza ne spremeni.

Argument index se pretvori v število, morebitni decimalni del pa se odreže proti ničli. Izpuščen argument, undefined in NaN pomenijo indeks 0. Metoda preveri obseg šele po uspešni pretvorbi. Če je dobljeni indeks zunaj obsega, na primer če je negativno celo število ali neskončnost, metoda vrne NaN. Pri praznem nizu je vsak indeks, dobljen s pretvorbo, zunaj obsega, vendar "".charCodeAt(0n) že med pretvorbo sproži napako TypeError. Negativni indeksi ne štejejo od konca.

Kodne enote ne zamenjujte s kodno točko Unicode. V primeru A zavzame eno kodno enoto, emoji pa dve: 55357 in 56832. charCodeAt vsako prebere posebej. Za branje kodne točke, ki se začne pri danem indeksu, uporabite codePointAt; indeks se še vedno meri v kodnih enotah UTF-16.

To je metoda standardne knjižnice ECMAScript, ne brskalniški spletni API. Po pretvorbi v niz lahko deluje tudi z drugimi vrednostmi prek String.prototype.charCodeAt.call(value, index), vendar vrednosti null in undefined za value povzročita napako TypeError.

Primeri

const text = "A\uD83D\uDE00";
console.log(text.charCodeAt(0));
console.log(text.charCodeAt(1));
console.log(text.charCodeAt(2));
console.log(text.charCodeAt(3));
console.log(text.charCodeAt());

Rezultat

65
55357
56832
NaN
65

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri