DataBuffer

Visite le stockage de sauvegarde de ce tampon.

L'implémentation du tampon est chargée de renvoyer une référence au stockage réel des données au visiteur fourni. Le visiteur n'a pas à gérer tous les types possibles de stockage de données et peut remplacer uniquement les méthodes de stockage qui l'intéressent réellement. Pour tout autre type de stockage, cet appel reviendra à fallback() afin que le visiteur puisse exécuter une routine générique si nécessaire.

Écrivez les références des objets du tableau source dans ce tampon.

S'il y a plus de valeurs à copier que la taille du tampon de destination, c'est-à-dire size > dst.size() , alors aucune valeur n'est transférée et une BufferOverflowException est levée. D'un autre côté, s'il y a plus de valeurs à copier que la taille du tampon source, c'est-à-dire > src.size() , alors une BufferUnderfloatException est levée.

Sinon, cette méthode copie les valeurs n = size de ce tampon dans le tampon de destination.

Vérifie l'égalité entre les tampons de données.

Un tampon de données est égal à un autre objet si cet objet est un autre DataBuffer de même taille, type et que les éléments sont égaux et dans le même ordre. Par exemple:

IntDataBuffer buffer = DataBuffers.of(1, 2, 3);

 assertEquals(buffer, DataBuffers.of(1, 2, 3));  // true
 assertEquals(buffer, DataBuffers.ofObjects(1, 2, 3));  // true, as Integers are equal to ints
 assertNotEquals(buffer, DataBuffers.of(1, 2, 3, 0));  // false, different sizes
 assertNotEquals(buffer, DataBuffers.of(1, 3, 2));  // false, different order
 assertNotEquals(buffer, DataBuffers.of(1L, 2L, 3L));  // false, different types
 

Notez que le calcul nécessaire pour vérifier l'égalité entre deux tampons peut être coûteux dans certains cas et par conséquent, il est recommandé de ne pas utiliser cette méthode dans un chemin critique où les performances comptent.

Lit la valeur à l'index donné. Important : L'utilisation de cette méthode doit être limitée aux tampons de types non primitifs ou lorsque le type de données n'est pas connu de manière déterministe par l'appelant. Dans tous les autres cas, préférez l'utilisation de sa variante primitive qui améliorera considérablement les performances (par exemple IntDataBuffer.getInt(idx)

Indique si ce tampon est soutenu ou non par un tableau accessible.

Crée un nouveau tampon dont le contenu est une sous-séquence partagée du contenu de ce tampon, dont la taille est définie sur la valeur donnée.

La nouvelle taille ne doit pas être supérieure à cette taille de tampon. Les modifications apportées au contenu de ce tampon seront visibles dans le nouveau tampon et vice versa. Le nouveau tampon sera en lecture seule si, et seulement si, ce tampon est en lecture seule.

Cet appel est équivalent à slice(0, size)

Crée un nouveau tampon dont le contenu est une sous-séquence partagée du contenu de ce tampon, en commençant à l'index donné.

L'index ne doit pas être supérieur à cette taille de tampon. Les modifications apportées au contenu de ce tampon seront visibles dans le nouveau tampon et vice versa. Le nouveau tampon sera en lecture seule si, et seulement si, ce tampon est en lecture seule.

Cet appel est équivalent à slice(index, size() - index)

Lisez les références des objets de ce tampon dans le tableau de destination.

Cette méthode transfère les valeurs de ce tampon vers le tableau de destination donné. S'il y a moins de valeurs dans le tampon que nécessaire pour satisfaire la demande, c'est-à-dire si dst.length > size() , alors aucune valeur n'est transférée et une BufferUnderflowException est levée.

Sinon, cette méthode copie les valeurs n = dst.length de ce tampon dans le tableau donné.

Lisez les références des objets de ce tampon dans le tableau de destination.

Cette méthode transfère les valeurs de ce tampon vers le tableau de destination donné. S'il y a moins de valeurs dans le tampon que nécessaire pour satisfaire la demande, c'est-à-dire si length > size() , alors aucune valeur n'est transférée et une BufferUnderflowException est levée.

Sinon, cette méthode copie les valeurs n = length de ce tampon dans le tableau donné en commençant au décalage donné.

Écrit la valeur donnée dans ce tampon à l'index donné. Important : L'utilisation de cette méthode doit être limitée aux tampons de types non primitifs ou lorsque le type de données n'est pas connu de manière déterministe par l'appelant. Dans tous les autres cas, préférez l'utilisation de sa variante primitive qui améliorera considérablement les performances (par exemple IntDataBuffer.setInt(idx)

Taille du buffer, en éléments.

Par exemple, dans le cas d'un tampon d'octets, cette valeur est égale au nombre d'octets que ce tampon peut contenir. Pour un tampon entier, il est égal au nombre d'entiers, donc la taille en octets de ce tampon est size() * Integer.BYTES .

Crée un nouveau tampon dont le contenu est une sous-séquence partagée du contenu de ce tampon, commençant à l'index donné et de la taille donnée.

L'index plus la nouvelle taille ne doivent pas être supérieurs à cette taille de tampon. Les modifications apportées au contenu de ce tampon seront visibles dans le nouveau tampon et vice versa. Le nouveau tampon sera en lecture seule si, et seulement si, ce tampon est en lecture seule.

Crée un DataBufferWindow qui fournit une vue partielle de ce tampon.

La fenêtre créée a une taille fixe et peut "slide" le long de ce tampon pour fournir différentes vues des données sans allouer une nouvelle instance de tampon, comme le fait offset(long) . Cela améliore les performances globales lorsque cette opération est répétée fréquemment. Par exemple:

IntDataBuffer bufferA = DataBuffers.ofInts(1024);
 // ... init buffer data
 IntDataBuffer bufferB = DataBuffers.ofInts(1, 2, 3, 4);

 // Return the index of the first occurrence of bufferB in bufferA using a sliding window
 DataBufferWindow<IntDataBuffer> windowA = bufferA.window(4);
 for (int i = 0; i < bufferA.size() - bufferB.size(); ++i) {
     if (windowA.slideTo(i).buffer().equals(bufferB)) {
         return i;
     
 }
 }

L'objet renvoyé est avec état et n'est pas thread-safe.

Écrivez les références des objets du tableau source dans ce tampon.

Cette méthode transfère les valeurs du tableau source donné dans ce tampon. S'il y a plus de valeurs dans le tableau source que dans ce tampon, c'est-à-dire si src.length > size() , alors aucune valeur n'est transférée et une BufferOverflowException est levée.

Sinon, cette méthode copie les valeurs n = src.length du tableau donné.

Méthode de put en bloc, utilisant des tableaux int.

Cette méthode transfère les valeurs du tableau source donné dans ce tampon. S'il y a plus de valeurs dans le tableau source que dans ce tampon, c'est-à-dire si length > size() , alors aucune valeur n'est transférée et une BufferOverflowException est levée.

Sinon, cette méthode copie les valeurs n = length du tableau donné dans ce tampon, en commençant au décalage donné.