CKTIS / Java
StandardCharsets — izričit odabir kodiranja teksta
StandardCharsets pruža gotove objekte Charset za standardna kodiranja koja zahtijeva platforma Java. Upotrijebite StandardCharsets.UTF_8 ili StandardCharsets.UTF_16BE kako biste izričito odredili pretvorbu teksta u bajtove i bajtova u tekst.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
import java.nio.charset.StandardCharsets;
byte[] bytes = text.getBytes(StandardCharsets.UTF_8);
String restored = new String(bytes, StandardCharsets.UTF_8);
byte[] bigEndian = text.getBytes(StandardCharsets.UTF_16BE);java.nio.charset.StandardCharsets sadrži konstante public static final tipa Charset, a ne nazive kodiranja tipa String. Kodiranje pretvara tekst u bajtove, a dekodiranje iz bajtova ponovno sastavlja tekst. Svaka implementacija platforme Java jamči podršku za kodiranja koja predstavljaju te konstante.
StandardCharsets.UTF_8 odabire UTF-8. StandardCharsets.UTF_16BE odabire UTF-16, pri čemu je najznačajniji bajt svake 16-bitne jedinice prvi. Nemojte zamijeniti UTF_16BE s UTF_16: pri kodiranju UTF_16BE ne dodaje oznaku redoslijeda bajtova (BOM), dok UTF_16 dodaje BOM i upotrebljava big-endian redoslijed. Pri dekodiranju pomoću UTF_16BE, početni BOM ostaje znak U+FEFF umjesto da određuje redoslijed bajtova.
Konstantu izričito proslijedite metodama text.getBytes(StandardCharsets.UTF_8) i new String(bytes, StandardCharsets.UTF_8). Pri čitanju odaberite kodiranje koje odgovara stvarnom formatu podataka; konstanta ga ne otkriva automatski. Izričit odabir uklanja ovisnost ove pretvorbe o zadanom skupu znakova.
Primjer kodira A\u0105 na dva načina i ispisuje bajtove heksadekadski. Očekivani izlaz je 41c485, 00410105, true, true, svaki u zasebnom retku. Posljednja dva retka provjeravaju vraća li dekodiranje istim kodiranjem izvorni tekst.
Primjeri
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;
public class Main {
public static void main(String[] args) {
String text = "A\u0105";
byte[] utf8 = text.getBytes(StandardCharsets.UTF_8);
byte[] utf16be = text.getBytes(StandardCharsets.UTF_16BE);
System.out.println(HexFormat.of().formatHex(utf8));
System.out.println(HexFormat.of().formatHex(utf16be));
System.out.println(text.equals(new String(utf8, StandardCharsets.UTF_8)));
System.out.println(text.equals(new String(utf16be, StandardCharsets.UTF_16BE)));
}
}Rezultat
41c485 00410105 true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.