ByteBuffer Classe

Définition

[Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)]
public abstract class ByteBuffer : Java.Nio.Buffer, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable

[<Android.Runtime.Register("java/nio/ByteBuffer", DoNotGenerateAcw=true)>]
type ByteBuffer = class
    inherit Buffer
    interface IComparable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Héritage

Object

Object

Buffer

ByteBuffer

Dérivé

Java.Nio.MappedByteBuffer

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IComparable IDisposable

Remarques

Mémoire tampon d’octets.

Cette classe définit six catégories d’opérations sur les mémoires tampons d’octets :

<ul>

<Li>

Absolu et relatif #get() <i>get</i> et #put(byte) <i>put</i> méthodes qui lisent et écrivent des octets uniques ;

</Li>

<Li>

Méthodes relatives #get(byte[]) <i>bulk get</i> qui transfèrent des séquences contiguës d’octets de cette mémoire tampon dans un tableau ;

</Li>

<Li>

Méthodes relatives #put(byte[]) <i>bulk put</i> qui transfèrent des séquences contiguës d’octets à partir d’un tableau d’octets ou d’une autre mémoire tampon d’octets dans cette mémoire tampon ;

</Li>

<Li>

Méthodes absolues et relatives #getChar() <i>get</i>#putChar(char) <i>put</i> qui lisent et écrivent des valeurs d’autres types primitifs, en les traduisant vers et à partir de séquences d’octets dans un ordre d’octet particulier ;

</Li>

<Li>

Méthodes de création de mémoires tampons d’affichage, qui permettent à une mémoire tampon d’octet d’être vue en tant que mémoire tampon contenant des valeurs d’un autre type primitif ; et

</Li>

<Li>

Méthodes pour #compact compacting, #duplicate duplicatinget #slice slicing une mémoire tampon d’octets.

</Li>

</ul>

Les mémoires tampons d’octets peuvent être créées soit par #allocate <i>allocation</i>, ce qui alloue de l’espace pour les mémoires tampons

contenu, ou par #wrap(byte[]) <i>wrapping</i> un tableau d’octets existant dans une mémoire tampon.

« direct"><h2> Direct vs. mémoires tampons non directes </h2>

Une mémoire tampon d’octets est directe ou non directe. Étant donné une mémoire tampon d’octets directe, la machine virtuelle Java fera le meilleur effort pour effectuer des opérations d’E/S natives directement sur celle-ci. Autrement dit, il tentera d’éviter de copier le contenu de la mémoire tampon vers (ou à partir) d’une mémoire tampon intermédiaire avant (ou après) chaque appel d’une des opérations d’E/S natives du système d’exploitation sous-jacent.

Une mémoire tampon d’octets directe peut être créée en appelant la #allocateDirect(int) allocateDirect méthode de fabrique de cette classe. Les mémoires tampons retournées par cette méthode ont généralement des coûts d’allocation et de désallocation un peu plus élevés que les mémoires tampons non directes. Le contenu des mémoires tampons directes peut résider en dehors du tas collecté par le garbage-collected normal, et leur impact sur l’empreinte mémoire d’une application peut ne pas être évident. Il est donc recommandé d’allouer des mémoires tampons directes principalement pour les mémoires tampons volumineuses et de longue durée soumises aux opérations d’E/S natives du système sous-jacent. En général, il est préférable d’allouer des mémoires tampons directes uniquement lorsqu’elles produisent un gain mesurable dans les performances du programme.

Une mémoire tampon d’octets directes peut également être créée par java.nio.channels.FileChannel#map mapping une région d’un fichier directement en mémoire. Une implémentation de la plateforme Java peut éventuellement prendre en charge la création de tampons d’octets directs à partir du code natif via JNI. Si une instance de l’un de ces types de mémoires tampons fait référence à une région inaccessible de mémoire, une tentative d’accès à cette région ne modifie pas le contenu de la mémoire tampon et entraîne la levée d’une exception non spécifiée au moment de l’accès ou ultérieurement.

Si une mémoire tampon d’octets est directe ou non directe peut être déterminée en appelant sa #isDirect isDirect méthode. Cette méthode est fournie afin que la gestion explicite des mémoires tampons puisse être effectuée dans du code critique pour les performances.

« bin"><h2> Accès aux données binaires </h2>

Cette classe définit des méthodes pour lire et écrire des valeurs de tous les autres types primitifs, à l’exception booleande . Les valeurs primitives sont traduites en séquences (ou à partir) d’octets en fonction de l’ordre d’octet actuel de la mémoire tampon, qui peut être récupéré et modifié via les #order order méthodes. Les ordres d’octet spécifiques sont représentés par des instances de la ByteOrder classe. L’ordre initial d’une mémoire tampon d’octets est toujours ByteOrder#BIG_ENDIAN BIG_ENDIAN.

Pour accéder à des données binaires hétérogènes, c’est-à-dire des séquences de valeurs de différents types, cette classe définit une famille de méthodes absolues et relatives get et put pour chaque type. Pour les valeurs à virgule flottante 32 bits, par exemple, cette classe définit :

<blockquote>

float  {@link #getFloat()}
            float  {@link #getFloat(int) getFloat(int index)}
             void  {@link #putFloat(float) putFloat(float f)}
             void  {@link #putFloat(int,float) putFloat(int index, float f)}

</blockquote>

Les méthodes correspondantes sont définies pour les types char, , shortint, longet double. Les paramètres d’index des méthodes get et put absolues sont en termes d’octets plutôt que du type en cours de lecture ou d’écriture.

« views »>

Pour accéder aux données binaires homogènes, autrement dit, les séquences de valeurs du même type, cette classe définit des méthodes qui peuvent créer des vues d’une mémoire tampon d’octets donnée. Une mémoire tampon d’affichage est simplement une autre mémoire tampon dont le contenu est sauvegardé par la mémoire tampon d’octets. Les modifications apportées au contenu de la mémoire tampon d’octets sont visibles dans la mémoire tampon d’affichage, et inversement ; la position, la limite et les valeurs de marque des deux mémoires tampons sont indépendantes. La #asFloatBuffer() asFloatBuffer méthode, par exemple, crée une instance de la FloatBuffer classe sauvegardée par la mémoire tampon d’octets sur laquelle la méthode est appelée. Les méthodes de création d’affichage correspondantes sont définies pour les types char, , shortint, longet double.

Les mémoires tampons d’affichage présentent trois avantages importants sur les familles de méthodes get et put spécifiques au type décrites ci-dessus :

<ul>

<Li>

Une mémoire tampon d’affichage n’est pas indexée en termes d’octets, mais plutôt en termes de taille spécifique au type de ses valeurs ;

</Li>

<Li>

Une mémoire tampon d’affichage fournit des méthodes d’obtention et de mise en bloc relatives qui peuvent transférer des séquences de valeurs contiguës entre une mémoire tampon et un tableau ou une autre mémoire tampon du même type ; et

</Li>

<Li>

Une mémoire tampon d’affichage est potentiellement beaucoup plus efficace, car elle sera directe si, et seulement si, sa mémoire tampon d’octet de stockage est directe.

</Li>

</ul>

L’ordre d’octet d’une mémoire tampon d’affichage est fixe pour être celui de sa mémoire tampon d’octets au moment où la vue est créé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.

Séquence d’instructions

<blockquote>

bb.putInt(0xCAFEBABE);
            bb.putShort(3);
            bb.putShort(45);

</blockquote>

peut, par exemple, être remplacé par l’instruction unique

<blockquote>

bb.putInt(0xCAFEBABE).putShort(3).putShort(45);

</blockquote>

Ajouté dans la version 1.4.

Documentation Java pour java.nio.ByteBuffer.

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

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à