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

CKTIS / Java

Lire les octets UTF-8 et utiliser les vues CharBuffer en lecture seule

Lisez tous les octets produits par l’encodeur UTF-8, puis retrouvez le contenu du CharBuffer grâce à une vue en lecture seule dotée de sa propre position.

Version : Java SE 21

Syntaxe

Java SE 21 — java.nio.ByteBuffer
static ByteBuffer wrap(byte[] array)
static ByteBuffer wrap(byte[] array, int offset, int length)
int remaining()
byte get()
ByteBuffer get(byte[] dst)
ByteBuffer get(byte[] dst, int offset, int length)
byte get(int index)
ByteBuffer get(int index, byte[] dst)
ByteBuffer get(int index, byte[] dst, int offset, int length)

java.nio.CharBuffer
CharBuffer asReadOnlyBuffer()
CharBuffer rewind()
int remaining()
int limit()
CharBuffer limit(int newLimit)
int position()
CharBuffer position(int newPosition)
CharBuffer slice()
CharBuffer slice(int index, int length)
char charAt(int index)
String toString()

En Java SE 21, la zone active d’un tampon java.nio est [position(), limit()) : la position indique le début et la limite est exclue. remaining() renvoie limit() - position(), en octets pour ByteBuffer et en unités de code UTF-16 (char), non en points de code Unicode, pour CharBuffer. position(int) accepte 0..limit() ; limit(int) accepte 0..capacity() et ramène la position à la nouvelle limite si nécessaire. Une valeur invalide déclenche IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) encode la zone active. En cas de succès, la position de cb atteint sa limite sans effacer les caractères. Le ByteBuffer renvoyé est prêt à être lu : sa position vaut zéro et sa limite marque la fin des octets produits. N’appelez pas flip() dessus. Pour tout lire, créez byte[] bytes = new byte[encoded.remaining()] puis appelez encoded.get(bytes). Par défaut, l’encodeur signale une entrée mal formée par CharacterCodingException.

ByteBuffer.wrap(array) partage le tableau d’octets sans le copier. La position vaut zéro, la limite et la capacité valent array.length. wrap(array, offset, length) conserve la capacité du tableau entier mais fixe la position à offset et la limite à offset + length. Une plage invalide déclenche IndexOutOfBoundsException. Les lectures relatives get(), get(dst) et get(dst, offset, length) lisent respectivement un octet, de quoi remplir le tableau de destination, ou length octets à partir de l’indice indiqué dans la destination. Elles avancent la position et, s’il manque des octets, déclenchent BufferUnderflowException sans transfert partiel. Les variantes absolues get(index) et get(index, dst[, offset, length]) ne déplacent pas la position ; un indice ou une plage invalide déclenche IndexOutOfBoundsException.

asReadOnlyBuffer() partage le contenu et reprend les valeurs initiales de position, de limite et de marque, qui évoluent ensuite indépendamment. Un put sur la vue déclenche ReadOnlyBufferException, mais les écritures effectuées dans le tampon modifiable restent visibles. Une vue créée après l’encodage a d’abord remaining() == 0. rewind() ramène sa position à zéro et efface sa marque sans toucher à sa limite. Pour relire la même zone, rétablissez explicitement l’ancienne position de départ si elle n’était pas nulle.

slice() crée une vue de la zone restante sans déplacer le tampon source. Sa position vaut zéro, sa limite et sa capacité correspondent à la longueur de la zone, sa marque est indéfinie et elle conserve le mode lecture seule. slice(index, length) part d’un indice absolu dans le tampon, non d’un décalage relatif à la position. La plage doit tenir dans [0, limit()) ; une plage vide peut partir de la limite. charAt(i) lit le char à position() + i sans avancer et exige 0 <= i < remaining(). Une plage de découpage ou un indice charAt invalide déclenche IndexOutOfBoundsException. toString() renvoie un String immuable de la zone active sans modifier la position.

Exemples

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;

public class BufferDemo {
    public static void main(String[] args) throws CharacterCodingException {
        CharBuffer cb = CharBuffer.wrap(new char[] {'[', '\u00E9', 'A', 'B', ']'});
        cb.position(1).limit(4);
        ByteBuffer encoded = StandardCharsets.UTF_8.newEncoder().encode(cb);
        System.out.println("input position=" + cb.position() + ", remaining=" + cb.remaining());

        byte[] bytes = new byte[encoded.remaining()];
        encoded.get(bytes);
        System.out.println("utf8=" + HexFormat.of().formatHex(bytes)
                + ", remaining=" + encoded.remaining());
        ByteBuffer suffix = ByteBuffer.wrap(bytes, 2, 2);
        System.out.println("suffix first=" + suffix.get() + ", remaining=" + suffix.remaining());

        CharBuffer view = cb.asReadOnlyBuffer();
        System.out.println("view initial remaining=" + view.remaining());
        view.rewind().position(2);
        CharBuffer tail = view.slice();
        System.out.println("charAt(0)=" + view.charAt(0) + ", view position=" + view.position()
                + ", input position=" + cb.position() + ", slice position=" + tail.position());

        String snapshot = tail.toString();
        cb.put(2, 'Z');
        System.out.println("snapshot=" + snapshot + ", slice now=" + tail.toString());
    }
}

Résultat

input position=4, remaining=0
utf8=c3a94142, remaining=0
suffix first=65, remaining=1
view initial remaining=0
charAt(0)=A, view position=2, input position=4, slice position=0
snapshot=AB, slice now=ZB

Trois valeurs `char` donnent quatre octets UTF-8. Après l’écriture dans le tampon d’origine, la vue découpée affiche `ZB`, tandis que le String précédent conserve `AB`.

Leçons associées

  • Java · Leçon 51 · Avancé · Version : 2

Sources