CKTIS / Java
StandardCharsets — choisir explicitement un encodage de texte
StandardCharsets fournit des objets Charset prêts à l’emploi pour les encodages standard exigés par la plateforme Java. Utilisez StandardCharsets.UTF_8 ou StandardCharsets.UTF_16BE pour préciser explicitement comment le texte devient des octets et comment les octets deviennent du texte.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 contient des constantes public static final de type Charset, et non des noms d’encodage de type String. L’encodage convertit le texte en octets ; le décodage reconstitue le texte à partir des octets. Les encodages représentés par ces constantes sont garantis comme étant pris en charge par toute implémentation de la plateforme Java.
StandardCharsets.UTF_8 sélectionne UTF-8. StandardCharsets.UTF_16BE sélectionne UTF-16, avec l’octet de poids fort de chaque unité de 16 bits en premier. Ne confondez pas UTF_16BE avec UTF_16 : lors de l’encodage, UTF_16BE n’ajoute pas de marque d’ordre des octets (BOM), tandis que UTF_16 ajoute une BOM et utilise l’ordre big-endian. Lors du décodage avec UTF_16BE, une BOM initiale reste un caractère U+FEFF au lieu de contrôler l’ordre des octets.
Passez explicitement la constante à text.getBytes(StandardCharsets.UTF_8) et à new String(bytes, StandardCharsets.UTF_8). Lors de la lecture, choisissez l’encodage correspondant au format réel des données ; la constante ne le détecte pas automatiquement. Un choix explicite supprime la dépendance de cette conversion à l’encodage par défaut.
L’exemple encode A\u0105 de deux façons et affiche les octets en hexadécimal. La sortie attendue est 41c485, 00410105, true, true, chacun sur une ligne distincte. Les deux dernières lignes vérifient que le décodage avec le même encodage reconstitue le texte.
Exemples
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)));
}
}Résultat
41c485 00410105 true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.