Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources