Buffer Classe

Définition

[Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)]
public abstract class Buffer : Java.Lang.Object

[<Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)>]
type Buffer = class
    inherit Object

Héritage

Object

JavaObject

Object

Buffer

Dérivé

Java.Nio.ByteBuffer

Java.Nio.CharBuffer

Java.Nio.DoubleBuffer

Java.Nio.FloatBuffer

Java.Nio.IntBuffer

Plus…

Attributs

RegisterAttribute

Remarques

Conteneur pour les données d’un type primitif spécifique.

Une mémoire tampon est une séquence linéaire et finie d’éléments d’un type primitif spécifique. Outre son contenu, les propriétés essentielles d’une mémoire tampon sont sa capacité, sa limite et sa position :

<blockquote>

La capacité d’une mémoire tampon est le nombre d’éléments qu’il contient. La capacité d’une mémoire tampon n’est jamais négative et ne change jamais.

La limite d’une mémoire tampon est l’index du premier élément qui ne doit pas être lu ou écrit. La limite d’une mémoire tampon n’est jamais négative et n’est jamais supérieure à sa capacité.

La position d’une mémoire tampon est l’index de l’élément suivant à lire ou écrire. La position d’une mémoire tampon n’est jamais négative et n’est jamais supérieure à sa limite.

</blockquote>

Il existe une sous-classe de cette classe pour chaque type primitif non booléen.

<h2> Transfert de données </h2>

Chaque sous-classe de cette classe définit deux catégories d’opérations get et put :

<blockquote>

Les opérations relatives lisent ou écrivent un ou plusieurs éléments à partir de la position actuelle, puis incrémentent la position par le nombre d’éléments transférés. Si le transfert demandé dépasse la limite, une opération d’obtention relative lève un BufferUnderflowException et une opération relative put lève un BufferOverflowException; dans les deux cas, aucune donnée n’est transférée.

Les opérations absolues prennent un index d’élément explicite et n’affectent pas la position. Les opérations d’obtention et de mise absolues lèvent une IndexOutOfBoundsException valeur si l’argument d’index dépasse la limite.

</blockquote>

Les données peuvent également être transférées vers ou hors d’une mémoire tampon par les opérations d’E/S d’un canal approprié, qui sont toujours relatives à la position actuelle.

< > Marquage et réinitialisation <de /h2>

La marque d’une mémoire tampon est l’index auquel sa position sera réinitialisée lorsque la #reset reset méthode est appelée. La marque n’est pas toujours définie, mais quand elle est définie, elle n’est jamais négative et n’est jamais supérieure à la position. Si la marque est définie, elle est ignorée lorsque la position ou la limite est ajustée à une valeur inférieure à la marque. Si la marque n’est pas définie, l’appel de la #reset reset méthode provoque une InvalidMarkException levée.

<h2> Invariants </h2>

L’invariant suivant contient les valeurs de marque, de position, de limite et de capacité :

< > 0 <= deposition<=de la marque<= blockquote<=<blockquote>

Une mémoire tampon nouvellement créée a toujours une position de zéro et une marque qui n’est pas définie. La limite initiale peut être égale à zéro, ou il peut s’agir d’une autre valeur qui dépend du type de la mémoire tampon et de la façon dont elle est construite. Chaque élément d’une mémoire tampon nouvellement allouée est initialisé à zéro.

<h2> Opérations <supplémentaires /h2>

Outre les méthodes permettant d’accéder aux valeurs de position, de limite et de capacité et de marquage et de réinitialisation, cette classe définit également les opérations suivantes sur les mémoires tampons :

<ul>

<li>

#clear rend une mémoire tampon prête pour une nouvelle séquence d’opérations de lecture de canal ou de put relative : elle définit la limite de capacité et la position sur zéro.

</li>

<li>

#flip prépare une mémoire tampon pour une nouvelle séquence d’opérations d’écriture de canal ou d’obtention relative : elle définit la limite à la position actuelle, puis définit la position sur zéro.

</li>

<li>

#rewind rend une mémoire tampon prête pour la relecture des données qu’elle contient déjà : elle laisse la limite inchangée et définit la position sur zéro.

</li>

<li>

Les #slice méthodes et #slice(int,int) slice(index,length) les méthodes créent une sous-séquence d’une mémoire tampon : elles conservent la limite et la position inchangée.

</li>

<li>

#duplicate crée une copie superficielle d’une mémoire tampon : elle laisse la limite et la position inchangée.

</li>

</ul>

<Mémoires tampons >en lecture seule h2< /h2>

Chaque mémoire tampon est lisible, mais pas chaque mémoire tampon est accessible en écriture. Les méthodes de mutation de chaque classe de mémoire tampon sont spécifiées en tant qu’opérations facultatives qui lèvent une ReadOnlyBufferException fois appelées sur une mémoire tampon en lecture seule. Une mémoire tampon en lecture seule n’autorise pas la modification de son contenu, mais ses valeurs de marque, de position et de limite sont mutables. Si une mémoire tampon est en lecture seule ou non, elle peut être déterminée en appelant sa #isReadOnly isReadOnly méthode.

<sécurité >des threads h2< /h2>

Les mémoires tampons ne sont pas sécurisées pour une utilisation par plusieurs threads simultanés. Si une mémoire tampon doit être utilisée par plusieurs threads, l’accès à la mémoire tampon doit être contrôlé par la synchronisation appropriée.

<chaînage >d’appel h2< /h2>

Les méthodes de cette classe qui n’ont pas autrement de valeur à retourner sont spécifiées pour retourner la mémoire tampon sur laquelle elles sont appelées. Cela permet aux appels de méthode d’être chaînés ; par exemple, la séquence d’instructions

<blockquote>

b.flip();
            b.position(23);
            b.limit(42);

</blockquote>

peut être remplacé par l’instruction single, plus compact

<blockquote>

b.flip().position(23).limit(42);

</blockquote>

Ajouté dans la version 1.4.

Java documentation pour java.nio.Buffer.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.