DataBuffer

Visita el almacenamiento de respaldo de este búfer.

La implementación del búfer es responsable de devolver una referencia al almacenamiento de datos real al visitante proporcionado. El visitante no tiene que manejar todos los tipos posibles de almacenamiento de datos y puede anular solo los métodos de almacenamiento que realmente le interesan. Para cualquier otro tipo de almacenamiento, esta llamada recurrirá a fallback() para que el visitante pueda ejecutar alguna rutina genérica si necesario.

Escriba las referencias de los objetos en la matriz de origen en este búfer.

Si hay más valores para copiar que el tamaño del búfer de destino, es decir, size > dst.size() , no se transfieren valores y se lanza una BufferOverflowException. Por otro lado, si hay más valores para copiar que el tamaño del búfer de origen, es decir, > src.size() , se lanza una BufferUnderfloatException.

De lo contrario, este método copia n = size valores de n = size de este búfer en el búfer de destino.

Comprueba la igualdad entre los búferes de datos.

Un búfer de datos es igual a otro objeto si este objeto es otro DataBuffer del mismo tamaño, tipo y los elementos son iguales y en el mismo orden. Por ejemplo:

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
 

Tenga en cuenta que el cálculo necesario para verificar la igualdad entre dos búferes puede ser costoso en algunos casos y, por lo tanto, se recomienda no utilizar este método en una ruta crítica donde el rendimiento importa.

Lee el valor en el índice dado. Importante: El uso de este método debe limitarse a búferes de tipos no primitivos o cuando el llamador no conoce de manera determinista el tipo de datos. En cualquier otro caso, prefiera el uso de su variante primitiva que mejorará significativamente el rendimiento (por ejemplo, IntDataBuffer.getInt(idx)

Indica si este búfer está respaldado por una matriz accesible.

Crea un nuevo búfer cuyo contenido es una subsecuencia compartida del contenido de este búfer, cuyo tamaño se establece en el valor dado.

El nuevo tamaño no debe ser mayor que este tamaño de búfer. Los cambios en el contenido de este búfer serán visibles en el nuevo búfer y viceversa. El nuevo búfer será de solo lectura si, y solo si, este búfer es de solo lectura.

Esta llamada es equivalente a slice(0, size)

Crea un nuevo búfer cuyo contenido es una subsecuencia compartida del contenido de este búfer, comenzando en el índice dado.

El índice no debe ser mayor que este tamaño de búfer. Los cambios en el contenido de este búfer serán visibles en el nuevo búfer y viceversa. El nuevo búfer será de solo lectura si, y solo si, este búfer es de solo lectura.

Esta llamada es equivalente a slice(index, size() - index)

Lea las referencias de los objetos en este búfer en la matriz de destino.

Este método transfiere valores de este búfer a la matriz de destino dada. Si hay menos valores en el búfer de los necesarios para satisfacer la solicitud, es decir, si dst.length > size() , no se transfieren valores y se lanza una BufferUnderflowException.

De lo contrario, este método copia los valores n = dst.length de este búfer en la matriz dada.

Lea las referencias de los objetos en este búfer en la matriz de destino.

Este método transfiere valores de este búfer a la matriz de destino dada. Si hay menos valores en el búfer de los necesarios para satisfacer la solicitud, es decir, si length > size() , no se transfieren valores y se lanza una BufferUnderflowException.

De lo contrario, este método copia n = length valores de n = length de este búfer en la matriz dada comenzando en el desplazamiento dado.

Escribe el valor dado en este búfer en el índice dado. Importante: El uso de este método debe limitarse a búferes de tipos no primitivos o cuando el llamador no conoce de manera determinista el tipo de datos. En cualquier otro caso, prefiera el uso de su variante primitiva que mejorará significativamente el rendimiento (por ejemplo, IntDataBuffer.setInt(idx)

Tamaño del búfer, en elementos.

Por ejemplo, en el caso de un búfer de bytes, este valor es igual al número de bytes que puede contener este búfer. Para un búfer de enteros, es igual al número de enteros, por lo tanto, el tamaño en bytes de este búfer es size() * Integer.BYTES .

Crea un nuevo búfer cuyo contenido es una subsecuencia compartida del contenido de este búfer, comenzando en el índice dado y del tamaño dado.

El índice más el nuevo tamaño no debe ser mayor que este tamaño de búfer. Los cambios en el contenido de este búfer serán visibles en el nuevo búfer y viceversa. El nuevo búfer será de solo lectura si, y solo si, este búfer es de solo lectura.

Crea un DataBufferWindow que proporciona una vista parcial de este búfer.

La ventana creada tiene un tamaño fijo y puede "slide" largo de este búfer para proporcionar diferentes vistas de los datos sin asignar una nueva instancia del búfer, como hace el offset(long) . Esto mejora el rendimiento general cuando esta operación se repite con frecuencia. Por ejemplo:

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;
     
 }
 }

El objeto devuelto tiene estado y no es seguro para subprocesos.

Escriba las referencias de los objetos en la matriz de origen en este búfer.

Este método transfiere los valores de la matriz de origen dada a este búfer. Si hay más valores en la matriz de origen que en este búfer, es decir, si src.length > size() , no se transfieren valores y se lanza una BufferOverflowException.

De lo contrario, este método copia los valores n = src.length de la matriz dada.

Mayor puso método, utilizando matrices int.

Este método transfiere los valores de la matriz de origen dada a este búfer. Si hay más valores en la matriz de origen que en este búfer, es decir, si length > size() , no se transfieren valores y se lanza una BufferOverflowException.

De lo contrario, este método copia n = length valores de n = length de la matriz dada en este búfer, comenzando en el desplazamiento dado.