CKTIS / Java
StandardCharsets — expliciet een tekencodering kiezen
StandardCharsets biedt kant-en-klare Charset-objecten voor standaardcoderingen die het Java-platform vereist. Gebruik StandardCharsets.UTF_8 of StandardCharsets.UTF_16BE om expliciet aan te geven hoe tekst bytes wordt en hoe bytes tekst worden.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
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 bevat public static final-constanten van het type Charset, geen coderingsnamen van het type String. Coderen zet tekst om in bytes; decoderen reconstrueert tekst uit bytes. Elke implementatie van het Java-platform ondersteunt gegarandeerd de coderingen die door deze constanten worden weergegeven.
StandardCharsets.UTF_8 kiest UTF-8. StandardCharsets.UTF_16BE kiest UTF-16, waarbij de meest significante byte van elke 16-bits eenheid eerst komt. Verwar UTF_16BE niet met UTF_16: bij het coderen voegt UTF_16BE geen byte-order mark (BOM) toe, terwijl UTF_16 wel een BOM toevoegt en big-endian-volgorde gebruikt. Bij decoderen met UTF_16BE blijft een initiële BOM het teken U+FEFF, in plaats van de bytevolgorde te bepalen.
Geef de constante expliciet door aan text.getBytes(StandardCharsets.UTF_8) en new String(bytes, StandardCharsets.UTF_8). Kies bij het lezen de codering die past bij de werkelijke gegevensindeling; de constante detecteert die niet automatisch. Met een expliciete keuze is deze omzetting niet afhankelijk van de standaardcodering.
Het voorbeeld codeert A\u0105 op twee manieren en drukt de bytes hexadecimaal af. De verwachte uitvoer is 41c485, 00410105, true, true, elk op een afzonderlijke regel. De laatste twee regels controleren of decoderen met dezelfde codering de tekst reconstrueert.
Voorbeelden
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)));
}
}Resultaat
41c485 00410105 true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.