DataBuffer

Visita o armazenamento de apoio deste buffer.

A implementação do buffer é responsável por retornar uma referência ao armazenamento de dados real para o 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 em que está realmente interessado. Para qualquer outro tipo de armazenamento, esta chamada irá 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() , uma BufferUnderfloatException é lançada.

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

Verifica a igualdade entre os 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 é deterministicamente conhecido pelo responsável pela chamada. Em qualquer outro caso, prefira o uso de sua variante primitiva que irá melhorar significativamente o desempenho (por exemplo, IntDataBuffer.getInt(idx)

Diz se este buffer é apoiado ou não por um array 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 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, este 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 deste buffer, começando no índice fornecido.

O índice não deve ser maior que o tamanho do buffer. Mudanças 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, este 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 desse buffer para a matriz de destino fornecida. Se houver menos valores no buffer do que o necessário para atender à 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 desse buffer para a matriz fornecida.

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

Este método transfere valores desse buffer para a matriz de destino fornecida. Se houver menos valores no buffer do que o necessário 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 n = length valores de 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 é deterministicamente conhecido pelo responsável pela chamada. Em qualquer outro caso, prefira o uso de sua variante primitiva que irá melhorar significativamente o desempenho (por exemplo, IntDataBuffer.setInt(idx)

Tamanho do buffer, em elementos.

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

Cria um novo buffer cujo conteúdo é uma subseqüência compartilhada do conteúdo desse buffer, começando com o índice fornecido e com o tamanho fornecido.

O índice mais o novo tamanho não deve ser maior que o tamanho do buffer. Mudanças 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, este buffer for somente leitura.

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

A janela criada tem um tamanho fixo e pode "slide" ao longo desse buffer para fornecer diferentes visualizações dos dados sem alocar uma nova instância de buffer, como o offset(long) faz. Isso 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 é seguro para threads.

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 da matriz fornecida.

Método Bulk put , 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 n = length valores de n = length da matriz fornecida para este buffer, começando no deslocamento fornecido.