ByteBuffer.Put Método

Definição

Sobrecargas

Nome Description
Put(Int32, ByteBuffer, Int32, Int32)

Método de colocação em massa absoluto    (operação opcional).

Put(Byte[], Int32, Int32)

Método de colocação em massa relativo    (operação opcional).

Put(Int32, SByte)

Método de put absoluto    (operação opcional).

Put(Int32, Byte[])

Método de colocação em massa absoluto    (operação opcional).

Put(Int32, Byte[], Int32, Int32)

Método de colocação em massa absoluto    (operação opcional).

Put(Byte[])

Método de colocação em massa relativo    (operação opcional).

Put(ByteBuffer)

Método de colocação em massa relativo    (operação opcional).

Put(SByte)

Método de put relativo    (operação opcional).

Put(Int32, ByteBuffer, Int32, Int32)

Método de colocação em massa absoluto    (operação opcional).

[Android.Runtime.Register("put", "(ILjava/nio/ByteBuffer;II)Ljava/nio/ByteBuffer;", "GetPut_ILjava_nio_ByteBuffer_IIHandler", ApiSince=35)]
public virtual Java.Nio.ByteBuffer Put(int index, Java.Nio.ByteBuffer src, int offset, int length);
[<Android.Runtime.Register("put", "(ILjava/nio/ByteBuffer;II)Ljava/nio/ByteBuffer;", "GetPut_ILjava_nio_ByteBuffer_IIHandler", ApiSince=35)>]
abstract member Put : int * Java.Nio.ByteBuffer * int * int -> Java.Nio.ByteBuffer
override this.Put : int * Java.Nio.ByteBuffer * int * int -> Java.Nio.ByteBuffer

Parâmetros

index
Int32

O índice nesse buffer no qual o primeiro byte será gravado; deve ser não negativo e menor que limit()

src
ByteBuffer

O buffer do qual os bytes devem ser lidos

offset
Int32

O índice dentro do buffer de origem do primeiro byte a ser lido; deve ser não negativo e menor que src.limit()

length
Int32

O número de bytes a serem lidos do buffer fornecido; deve ser não negativo e não maior que o menor de limit() - index e src.limit() - offset

Retornos

Esse buffer

Atributos

Comentários

Método de colocação em massa absoluto    (operação opcional).

Esse método transfere length bytes para esse buffer do buffer de origem fornecido, começando no dado offset no buffer de origem e no fornecido index neste buffer. As posições de ambos os buffers não são alteradas.

Em outras palavras, uma invocação desse método do formulário dst.put(index,&nbsp;src,&nbsp;offset,&nbsp;length) tem exatamente o mesmo efeito que o loop

{@code
            for (int i = offset, j = index; i < offset + length; i++, j++)
                dst.put(j, src.get(i));
            }

exceto que primeiro verifica a consistência dos parâmetros fornecidos e é potencialmente muito mais eficiente. Se esse buffer e o buffer de origem compartilharem a mesma matriz de backup ou memória, o resultado será como se os elementos de origem fossem copiados primeiro para um local intermediário antes de serem gravados nesse buffer.

Adicionado em 16.

Java documentação para java.nio.ByteBuffer.put(int, java.nio.ByteBuffer, int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(Byte[], Int32, Int32)

Método de colocação em massa relativo    (operação opcional).

[Android.Runtime.Register("put", "([BII)Ljava/nio/ByteBuffer;", "GetPut_arrayBIIHandler")]
public virtual Java.Nio.ByteBuffer Put(byte[] src, int offset, int length);
[<Android.Runtime.Register("put", "([BII)Ljava/nio/ByteBuffer;", "GetPut_arrayBIIHandler")>]
abstract member Put : byte[] * int * int -> Java.Nio.ByteBuffer
override this.Put : byte[] * int * int -> Java.Nio.ByteBuffer

Parâmetros

src
Byte[]

A matriz da qual os bytes devem ser lidos

offset
Int32

O deslocamento dentro da matriz do primeiro byte a ser lido; deve ser não negativo e não maior que src.length

length
Int32

O número de bytes a serem lidos da matriz determinada; deve ser não negativo e não maior que src.length - offset

Retornos

Esse buffer

Atributos

Exceções

se remaining() for menor que byteCount.

se for srcOffset inválido ou byteCount inválido.

se nenhuma alteração puder ser feita no conteúdo desse buffer.

Comentários

Método de colocação em massa relativo    (operação opcional).

Esse método transfere bytes para esse buffer da matriz de origem fornecida. Se houver mais bytes a serem copiados da matriz do que permanecer nesse buffer, ou seja, se length > remaining(), em seguida, nenhum bytes são transferidos e um BufferOverflowException é lançado.

Caso contrário, esse método copia length bytes da matriz fornecida para esse buffer, começando no deslocamento fornecido na matriz e na posição atual desse buffer. A posição desse buffer é incrementada por length.

Em outras palavras, uma invocação desse método do formulário dst.put(src,&nbsp;off,&nbsp;len) tem exatamente o mesmo efeito que o loop

{@code
                for (int i = off; i < off + len; i++)
                    dst.put(src[i]);
            }

exceto que ele primeiro verifica se há espaço suficiente nesse buffer e é potencialmente muito mais eficiente.

Java documentação para java.nio.ByteBuffer.put(byte[], int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(Int32, SByte)

Método de put absoluto    (operação opcional).

[Android.Runtime.Register("put", "(IB)Ljava/nio/ByteBuffer;", "GetPut_IBHandler")]
public abstract Java.Nio.ByteBuffer Put(int index, sbyte b);
[<Android.Runtime.Register("put", "(IB)Ljava/nio/ByteBuffer;", "GetPut_IBHandler")>]
abstract member Put : int * sbyte -> Java.Nio.ByteBuffer

Parâmetros

index
Int32

O índice no qual o byte será gravado

b
SByte

O valor de byte a ser gravado

Retornos

Esse buffer

Atributos

Exceções

se index for inválido.

se nenhuma alteração puder ser feita no conteúdo desse buffer.

Comentários

Método de put absoluto    (operação opcional).

Grava o byte fornecido nesse buffer no índice fornecido.

Java documentação para java.nio.ByteBuffer.put(int, byte).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(Int32, Byte[])

Método de colocação em massa absoluto    (operação opcional).

[Android.Runtime.Register("put", "(I[B)Ljava/nio/ByteBuffer;", "GetPut_IarrayBHandler", ApiSince=35)]
public virtual Java.Nio.ByteBuffer Put(int index, byte[] src);
[<Android.Runtime.Register("put", "(I[B)Ljava/nio/ByteBuffer;", "GetPut_IarrayBHandler", ApiSince=35)>]
abstract member Put : int * byte[] -> Java.Nio.ByteBuffer
override this.Put : int * byte[] -> Java.Nio.ByteBuffer

Parâmetros

index
Int32

O índice nesse buffer no qual o primeiro byte será gravado; deve ser não negativo e menor que limit()

src
Byte[]

A matriz da qual os bytes devem ser lidos

Retornos

Esse buffer

Atributos

Comentários

Método de colocação em massa absoluto    (operação opcional).

Esse método copia bytes para esse buffer da matriz de origem fornecida. A posição desse buffer não é alterada. Uma invocação desse método do formulário dst.put(index,&nbsp;src) se comporta exatamente da mesma maneira que a invocação:

dst.put(index, src, 0, src.length);

Adicionado em 13.

Java documentação para java.nio.ByteBuffer.put(int, byte[]).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(Int32, Byte[], Int32, Int32)

Método de colocação em massa absoluto    (operação opcional).

[Android.Runtime.Register("put", "(I[BII)Ljava/nio/ByteBuffer;", "GetPut_IarrayBIIHandler", ApiSince=35)]
public virtual Java.Nio.ByteBuffer Put(int index, byte[] src, int offset, int length);
[<Android.Runtime.Register("put", "(I[BII)Ljava/nio/ByteBuffer;", "GetPut_IarrayBIIHandler", ApiSince=35)>]
abstract member Put : int * byte[] * int * int -> Java.Nio.ByteBuffer
override this.Put : int * byte[] * int * int -> Java.Nio.ByteBuffer

Parâmetros

index
Int32

O índice nesse buffer no qual o primeiro byte será gravado; deve ser não negativo e menor que limit()

src
Byte[]

A matriz da qual os bytes devem ser lidos

offset
Int32

O deslocamento dentro da matriz do primeiro byte a ser lido; deve ser não negativo e menor que src.length

length
Int32

O número de bytes a serem lidos da matriz determinada; deve ser não negativo e não maior que o menor de limit() - index e src.length - offset

Retornos

Esse buffer

Atributos

Comentários

Método de colocação em massa absoluto    (operação opcional).

Esse método transfere length bytes da matriz fornecida, começando no deslocamento fornecido na matriz e no índice fornecido nesse buffer. A posição desse buffer não é alterada.

Uma invocação desse método do formulário dst.put(index,&nbsp;src,&nbsp;offset,&nbsp;length) tem exatamente o mesmo efeito que o loop a seguir, exceto que primeiro verifica a consistência dos parâmetros fornecidos e é potencialmente muito mais eficiente:

{@code
                for (int i = offset, j = index; i < offset + length; i++, j++)
                    dst.put(j, src[i]);
            }

Adicionado em 13.

Java documentação para java.nio.ByteBuffer.put(int, byte[], int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(Byte[])

Método de colocação em massa relativo    (operação opcional).

[Android.Runtime.Register("put", "([B)Ljava/nio/ByteBuffer;", "")]
public Java.Nio.ByteBuffer Put(byte[] src);
[<Android.Runtime.Register("put", "([B)Ljava/nio/ByteBuffer;", "")>]
member this.Put : byte[] -> Java.Nio.ByteBuffer

Parâmetros

src
Byte[]

A matriz de origem

Retornos

Esse buffer

Atributos

Exceções

se remaining() for menor que src.length.

se nenhuma alteração puder ser feita no conteúdo desse buffer.

Comentários

Método de colocação em massa relativo    (operação opcional).

Esse método transfere todo o conteúdo da matriz de bytes de origem fornecida para esse buffer. Uma invocação desse método do formulário dst.put(a) se comporta exatamente da mesma maneira que a invocação

dst.put(a, 0, a.length)

Java documentação para java.nio.ByteBuffer.put(byte[]).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(ByteBuffer)

Método de colocação em massa relativo    (operação opcional).

[Android.Runtime.Register("put", "(Ljava/nio/ByteBuffer;)Ljava/nio/ByteBuffer;", "GetPut_Ljava_nio_ByteBuffer_Handler")]
public virtual Java.Nio.ByteBuffer Put(Java.Nio.ByteBuffer src);
[<Android.Runtime.Register("put", "(Ljava/nio/ByteBuffer;)Ljava/nio/ByteBuffer;", "GetPut_Ljava_nio_ByteBuffer_Handler")>]
abstract member Put : Java.Nio.ByteBuffer -> Java.Nio.ByteBuffer
override this.Put : Java.Nio.ByteBuffer -> Java.Nio.ByteBuffer

Parâmetros

src
ByteBuffer

O buffer de origem do qual os bytes devem ser lidos; não deve ser esse buffer

Retornos

Esse buffer

Atributos

Exceções

se src.remaining() for maior que o buffer.remaining()

se src for esse buffer.

se nenhuma alteração puder ser feita no conteúdo desse buffer.

Comentários

Método de colocação em massa relativo    (operação opcional).

Esse método transfere os bytes restantes no buffer de origem fornecido para esse buffer. Se houver mais bytes restantes no buffer de origem do que neste buffer, ou seja, se src.remaining() > remaining(), em seguida, nenhum bytes são transferidos e um BufferOverflowException é lançado.

Caso contrário, esse método copia n = src.remaining() bytes do buffer fornecido para esse buffer, começando na posição atual de cada buffer. As posições de ambos os buffers são incrementadas por n.

Em outras palavras, uma invocação desse método do formulário dst.put(src) tem exatamente o mesmo efeito que o loop

while (src.hasRemaining())
                    dst.put(src.get()); 

exceto que ele primeiro verifica se há espaço suficiente nesse buffer e é potencialmente muito mais eficiente. Se esse buffer e o buffer de origem compartilharem a mesma matriz de backup ou memória, o resultado será como se os elementos de origem fossem copiados primeiro para um local intermediário antes de serem gravados nesse buffer.

Java documentação para java.nio.ByteBuffer.put(java.nio.ByteBuffer).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

Put(SByte)

Método de put relativo    (operação opcional).

[Android.Runtime.Register("put", "(B)Ljava/nio/ByteBuffer;", "GetPut_BHandler")]
public abstract Java.Nio.ByteBuffer Put(sbyte b);
[<Android.Runtime.Register("put", "(B)Ljava/nio/ByteBuffer;", "GetPut_BHandler")>]
abstract member Put : sbyte -> Java.Nio.ByteBuffer

Parâmetros

b
SByte

O byte a ser escrito

Retornos

Esse buffer

Atributos

Exceções

se a posição for igual ou maior que o limite.

se nenhuma alteração puder ser feita no conteúdo desse buffer.

Comentários

Método de put relativo    (operação opcional).

Grava o byte fornecido nesse buffer na posição atual e incrementa a posição.

Java documentação para java.nio.ByteBuffer.put(byte).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a