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 sólo 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 fuente 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 genera 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() , entonces se lanza una BufferUnderfloatException.

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

Comprueba la igualdad entre los buffers de datos.

Un buffer 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 buffers 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 buffers de tipos no primitivos o cuando el autor de la llamada 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 sólo lectura si, y sólo si, este búfer es de sólo 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 sólo lectura si, y sólo si, este búfer es de sólo 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 transfiere ningún valor y se genera 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 transfiere ningún valor y se genera una BufferUnderflowException.

De lo contrario, este método copia 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 buffers de tipos no primitivos o cuando el autor de la llamada 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 buffer, en elementos.

Por ejemplo, en el caso de un búfer de bytes, este valor es igual al número de bytes que este búfer puede contener. Para un búfer de números enteros, es igual al número de números 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 sólo lectura si, y sólo si, este búfer es de sólo lectura.

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

La ventana creada tiene un tamaño fijo y puede "slide" a lo largo de este búfer para proporcionar diferentes vistas de los datos sin asignar una nueva instancia de búfer, como lo hace 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 fuente en este búfer.

Este método transfiere los valores de la matriz fuente 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 genera una BufferOverflowException.

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

Método de venta masiva, utilizando matrices int.

Este método transfiere los valores de la matriz fuente 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 genera una BufferOverflowException.

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