ByteBuffer.Put Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| Put(ByteBuffer) |
Relative bulk put method (optional operation). |
| Put(Byte[]) |
Relative bulk put method (optional operation). |
| Put(SByte) |
Relative put method (optional operation). |
| Put(Int32, SByte) |
Absolute put method (optional operation). |
| Put(Byte[], Int32, Int32) |
Relative bulk put method (optional operation). |
Put(ByteBuffer)
Relative bulk put method (optional operation).
[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.ByteBufferParameters
- src
- ByteBuffer
The source buffer from which bytes are to be read; must not be this buffer
Returns
This buffer
- Attributes
Exceptions
if src.remaining() is greater than this buffer's
remaining().
if src is this buffer.
if no changes may be made to the contents of this buffer.
Remarks
Relative bulk put method (optional operation).
This method transfers the bytes remaining in the given source buffer into this buffer. If there are more bytes remaining in the source buffer than in this buffer, that is, if src.remaining() > remaining(), then no bytes are transferred and a BufferOverflowException is thrown.
Otherwise, this method copies n = src.remaining() bytes from the given buffer into this buffer, starting at each buffer's current position. The positions of both buffers are then incremented by n.
In other words, an invocation of this method of the form dst.put(src) has exactly the same effect as the loop
while (src.hasRemaining())
dst.put(src.get());
except that it first checks that there is sufficient space in this buffer and it is potentially much more efficient.
Java documentation for java.nio.ByteBuffer.put(java.nio.ByteBuffer).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Applies to
Put(Byte[])
Relative bulk put method (optional operation).
[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.ByteBufferParameters
- src
- Byte[]
The source array
Returns
This buffer
- Attributes
Exceptions
if remaining() is less than src.length.
if no changes may be made to the contents of this buffer.
Remarks
Relative bulk put method (optional operation).
This method transfers the entire content of the given source byte array into this buffer. An invocation of this method of the form dst.put(a) behaves in exactly the same way as the invocation
dst.put(a, 0, a.length)
Java documentation for java.nio.ByteBuffer.put(byte[]).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Applies to
Put(SByte)
Relative put method (optional operation).
[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.ByteBufferParameters
- b
- SByte
The byte to be written
Returns
This buffer
- Attributes
Exceptions
if position is equal or greater than limit.
if no changes may be made to the contents of this buffer.
Remarks
Relative put method (optional operation).
Writes the given byte into this buffer at the current position, and then increments the position.
Java documentation for java.nio.ByteBuffer.put(byte).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Applies to
Put(Int32, SByte)
Absolute put method (optional operation).
[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.ByteBufferParameters
- index
- Int32
The index at which the byte will be written
- b
- SByte
The byte value to be written
Returns
This buffer
- Attributes
Exceptions
if index is invalid.
if no changes may be made to the contents of this buffer.
Remarks
Absolute put method (optional operation).
Writes the given byte into this buffer at the given index.
Java documentation for java.nio.ByteBuffer.put(int, byte).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Applies to
Put(Byte[], Int32, Int32)
Relative bulk put method (optional operation).
[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.ByteBufferParameters
- src
- Byte[]
The array from which bytes are to be read
- offset
- Int32
The offset within the array of the first byte to be read;
must be non-negative and no larger than array.length
- length
- Int32
The number of bytes to be read from the given array;
must be non-negative and no larger than
array.length - offset
Returns
This buffer
- Attributes
Exceptions
if remaining() is less than byteCount.
if either srcOffset or byteCount is invalid.
if no changes may be made to the contents of this buffer.
Remarks
Relative bulk put method (optional operation).
This method transfers bytes into this buffer from the given source array. If there are more bytes to be copied from the array than remain in this buffer, that is, if length > remaining(), then no bytes are transferred and a BufferOverflowException is thrown.
Otherwise, this method copies length bytes from the given array into this buffer, starting at the given offset in the array and at the current position of this buffer. The position of this buffer is then incremented by length.
In other words, an invocation of this method of the form dst.put(src, off, len) has exactly the same effect as the loop
{@code
for (int i = off; i < off + len; i++)
dst.put(a[i]);
}
except that it first checks that there is sufficient space in this buffer and it is potentially much more efficient.
Java documentation for java.nio.ByteBuffer.put(byte[], int, int).
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.