CKTIS / Java
CharsetEncoder — encoder des caractères en octets
CharsetEncoder convertit des caractères Unicode en octets dans un jeu de caractères choisi. Il permet de gérer explicitement les erreurs et d’encoder un tampon entier ou des portions successives de texte.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
CharsetEncoder encoder = charset.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap(text));
encoder.reset();
CoderResult result = encoder.encode(in, out, endOfInput);CharsetEncoder de java.nio.charset encode des caractères en octets ; CharsetDecoder effectue l’opération inverse. Créez un encodeur avec charset.newEncoder() en choisissant explicitement le jeu de caractères.
CharsetEncoder.encode(CharBuffer) effectue la réinitialisation, l’encodage et la vidange finale de l’état. La méthode renvoie un nouveau ByteBuffer prêt à être lu : sa position est zéro et sa limite marque la fin des données. Ne l’appelez pas au cours d’une opération en cours.
encode(in, out, endOfInput) fait avancer les positions des tampons et renvoie CoderResult. En cas de OVERFLOW, récupérez les octets ; en cas de UNDERFLOW, conservez les caractères non consommés avant d’en ajouter d’autres. Commencez une nouvelle opération avec reset() (inutile lors de la première utilisation) ; terminez l’encodage avec endOfInput = true, puis appelez flush(out) jusqu’à obtenir UNDERFLOW.
Le comportement par défaut REPORT distingue un UTF-16 mal formé des caractères valides impossibles à représenter dans le jeu de caractères. La variante à tampon unique lève CharacterCodingException ; la variante en flux renvoie un résultat d’erreur. IGNORE et REPLACE peuvent entraîner une perte d’informations. Ne partagez pas un encodeur entre des threads qui s’exécutent simultanément.
Exemples
import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.CharsetEncoder;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws CharacterCodingException {
CharsetEncoder encoder = StandardCharsets.UTF_8.newEncoder();
ByteBuffer bytes = encoder.encode(CharBuffer.wrap("A\u20AC"));
while (bytes.hasRemaining()) {
System.out.println(bytes.get() & 0xFF);
}
}
}Résultat
65 226 130 172
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.