DataBuffer

Visita o armazenamento de apoio deste buffer.

A implementação do buffer é responsável por devolver uma referência ao armazenamento real de dados ao visitante fornecido. O visitante não precisa lidar com todos os tipos possíveis de armazenamento de dados e pode substituir apenas os métodos de armazenamento nos quais está realmente interessado. Para qualquer outro tipo de armazenamento, esta chamada retornará para fallback() para que o visitante possa executar alguma rotina genérica se necessário.

Escreva as referências dos objetos na matriz de origem neste buffer.

Se houver mais valores para copiar do que o tamanho do buffer de destino, ou seja, size > dst.size() , nenhum valor será transferido e uma BufferOverflowException será lançada. Por outro lado, se houver mais valores para copiar do que o tamanho do buffer de origem, ou seja > src.size() , então uma BufferUnderfloatException será lançada.

Caso contrário, este método copia valores n = size deste buffer para o buffer de destino.

Verifica a igualdade entre buffers de dados.

Um buffer de dados é igual a outro objeto se este objeto for outro DataBuffer do mesmo tamanho, tipo e os elementos forem iguais e na mesma ordem. Por exemplo:

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
 

Observe que o cálculo necessário para verificar a igualdade entre dois buffers pode ser caro em alguns casos e, portanto, é recomendado não usar este método em um caminho crítico onde o desempenho é importante.

Lê o valor no índice fornecido. Importante: O uso deste método deve ser limitado a buffers de tipos não primitivos ou quando o tipo de dados não é conhecido deterministicamente pelo chamador. Em qualquer outro caso, prefira o uso de sua variante primitiva que melhorará significativamente o desempenho (por exemplo IntDataBuffer.getInt(idx)

Informa se este buffer é ou não apoiado por uma matriz acessível.

Cria um novo buffer cujo conteúdo é uma subsequência compartilhada do conteúdo deste buffer, cujo tamanho é definido para o valor fornecido.

O novo tamanho não deve ser maior que esse tamanho de buffer. As alterações no conteúdo deste buffer serão visíveis no novo buffer e vice-versa. O novo buffer será somente leitura se, e somente se, esse buffer for somente leitura.

Esta chamada é equivalente a slice(0, size)

Cria um novo buffer cujo conteúdo é uma subsequência compartilhada do conteúdo desse buffer, começando no índice fornecido.

O índice não deve ser maior que esse tamanho de buffer. As alterações no conteúdo deste buffer serão visíveis no novo buffer e vice-versa. O novo buffer será somente leitura se, e somente se, esse buffer for somente leitura.

Esta chamada é equivalente a slice(index, size() - index)

Leia as referências dos objetos neste buffer na matriz de destino.

Este método transfere valores deste buffer para o array de destino fornecido. Se houver menos valores no buffer do que os necessários para satisfazer a solicitação, ou seja, se dst.length > size() , nenhum valor será transferido e uma BufferUnderflowException será lançada.

Caso contrário, este método copia os valores n = dst.length deste buffer para o array fornecido.

Leia as referências dos objetos neste buffer na matriz de destino.

Este método transfere valores deste buffer para o array de destino fornecido. Se houver menos valores no buffer do que os necessários para satisfazer a solicitação, ou seja, se length > size() , nenhum valor será transferido e uma BufferUnderflowException será lançada.

Caso contrário, este método copia valores n = length deste buffer para o array fornecido, começando no deslocamento fornecido.

Grava o valor fornecido neste buffer no índice fornecido. Importante: O uso deste método deve ser limitado a buffers de tipos não primitivos ou quando o tipo de dados não é conhecido deterministicamente pelo chamador. Em qualquer outro caso, prefira o uso de sua variante primitiva que melhorará significativamente o desempenho (por exemplo, IntDataBuffer.setInt(idx)

Tamanho do buffer, em elementos.

Por exemplo, no caso de um buffer de bytes, este valor é igual ao número de bytes que este buffer pode conter. Para um buffer inteiro, é igual ao número de inteiros, portanto o tamanho em bytes deste buffer é size() * Integer.BYTES .

Cria um novo buffer cujo conteúdo é uma subsequência compartilhada do conteúdo desse buffer, começando no índice e no tamanho especificados.

O índice mais o novo tamanho não deve ser maior que o tamanho do buffer. As alterações no conteúdo deste buffer serão visíveis no novo buffer e vice-versa. O novo buffer será somente leitura se, e somente se, esse buffer for somente leitura.

Cria um DataBufferWindow que fornece uma visão parcial desse buffer.

A janela criada tem um tamanho fixo e pode "slide" ao longo deste buffer para fornecer diferentes visualizações dos dados sem alocar uma nova instância de buffer, como faz offset(long) . Isto melhora o desempenho geral quando esta operação é repetida com frequência. Por exemplo:

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

O objeto retornado tem estado e não é thread-safe.

Escreva as referências dos objetos na matriz de origem neste buffer.

Este método transfere os valores da matriz de origem fornecida para este buffer. Se houver mais valores na matriz de origem do que neste buffer, ou seja, se src.length > size() , nenhum valor será transferido e uma BufferOverflowException será lançada.

Caso contrário, este método copia os valores n = src.length do array fornecido.

Método de colocação em massa, usando matrizes int.

Este método transfere os valores da matriz de origem fornecida para este buffer. Se houver mais valores na matriz de origem do que neste buffer, ou seja, se length > size() , nenhum valor será transferido e uma BufferOverflowException será lançada.

Caso contrário, este método copia valores n = length do array fornecido para este buffer, começando no deslocamento fornecido.