CKTIS / Java
CharBuffer : plages de données et vues partagées
CharBuffer contient des valeurs char dans une plage contrôlée par position et limit. Découvrez l’indexation relative à la position et la différence entre une vue partagée en lecture seule et une copie des données.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer est un tampon de valeurs char. CharBuffer.position() indique la prochaine position, CharBuffer.limit() la limite exclusive et CharBuffer.remaining() renvoie limit() - position(). position(int) et limit(int) définissent respectivement la position et la limite. remaining() n’a pas de surcharge prenant un argument et aucune méthode ne permet de définir directement le nombre d’éléments restants. La condition 0 <= position() <= limit() <= capacity() est respectée. Si la limite est abaissée sous la position, la position est également abaissée.
CharBuffer.charAt(i) lit l’élément situé à position() + i sans avancer la position ; il faut que 0 <= i < remaining(). CharBuffer.toString() renvoie le texte de [position(), limit()), sans avancer la position non plus.
CharBuffer.slice() crée une vue partagée de la plage restante : la position vaut zéro, et la limite ainsi que la capacité sont égales au remaining() initial. CharBuffer.asReadOnlyBuffer() partage les données et conserve au départ l’état de la source. La position, la limite et le marqueur de chaque vue sont indépendants. Lecture seule ne signifie pas données immuables : les écritures effectuées par une autre vue modifiable restent visibles ; écrire par la vue en lecture seule déclenche ReadOnlyBufferException.
CharBuffer.rewind() remet la position à zéro et supprime le marqueur, tout en conservant la limite et les données. Cette méthode fonctionne aussi sur une vue en lecture seule. Dans l’exemple, les modifications faites par s sont visibles par ro, mais déplacer ro ne change pas la position de b.
Exemples
import java.nio.CharBuffer;
public class Main {
public static void main(String[] args) {
CharBuffer b = CharBuffer.wrap(new char[] {'A', 'B', 'C', 'D', 'E'});
b.position(1).limit(4);
CharBuffer s = b.slice();
CharBuffer ro = s.asReadOnlyBuffer();
System.out.println(b.remaining() + ":" + b.charAt(0) + ":" + b.toString());
s.put(0, 'X');
ro.position(1);
System.out.println(ro.toString());
ro.rewind();
System.out.println(ro.toString());
System.out.println(b.position() + ":" + b.limit() + ":" + b.toString());
}
}Résultat
3:B:BCD CD XCD 1:4:XCD
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.