org.bytedeco.javacpp

Class BytePointer

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.BytePointer

public class BytePointer
extends Pointer

The peer class to native pointers and arrays of signed char, including strings. All operations take into account the position and limit, when appropriate.

Author:

Samuel Audet

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
BytePointer()
BytePointer(byte... array) Allocates enough memory for the array and copies it.
BytePointer(ByteBuffer buffer) For direct buffers, calls Pointer.Pointer(Buffer), while for buffers backed with an array, allocates enough memory for the array and copies it.
BytePointer(int size) Allocates a native signed char array of the given size.
BytePointer(Pointer p)
BytePointer(String s) Allocates enough memory for the encoded string and actually encodes it in the platform's default charset before copying it.
BytePointer(String s, String charsetName) Allocates enough memory for the encoded string and actually encodes it in the named charset before copying it.

Method Summary

Modifier and Type	Method and Description
private void	allocateArray(int size)
ByteBuffer	asBuffer() Same as Pointer.asByteBuffer(), but can be overridden to return subclasses of Buffer.
BytePointer	capacity(int capacity) Sets the capacity and returns this.
byte	get()
BytePointer	get(byte[] array)
BytePointer	get(byte[] array, int offset, int length) Reads a portion of the native array into a Java array.
byte	get(int i)
String	getString() Decodes the native bytes assuming they are encoded in the platform's default charset.
String	getString(String charsetName) Decodes the native bytes assuming they are encoded in the named charset.
byte[]	getStringBytes()
BytePointer	limit(int limit) Sets the limit and returns this.
BytePointer	position(int position) Sets the position and returns this.
BytePointer	put(byte... array)
BytePointer	put(byte b)
BytePointer	put(byte[] array, int offset, int length) Writes a portion of a Java array into the native array.
BytePointer	put(int i, byte b) Copies the byte value to the i-th element of a native array.
BytePointer	putString(String s) Encodes the String into the platform's default charset and copies it in native memory, including a terminating null byte.
BytePointer	putString(String s, String charsetName) Encodes the String into the named charset and copies it in native memory, including a terminating null byte.

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asByteBuffer, capacity, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, hashCode, init, isNull, limit, memchr, memcmp, memcpy, memmove, memset, offsetof, position, put, setNull, sizeof, toString, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

BytePointer

public BytePointer(String s,
                   String charsetName)
            throws UnsupportedEncodingException

Allocates enough memory for the encoded string and actually encodes it in the named charset before copying it.

Parameters:

s - the String to encode and copy

charsetName - the charset in which the bytes are encoded

Throws:

UnsupportedEncodingException

See Also:

putString(String, String)

BytePointer

public BytePointer(String s)

Allocates enough memory for the encoded string and actually encodes it in the platform's default charset before copying it.

Parameters:

s - the String to encode and copy

See Also:

putString(String)

BytePointer

public BytePointer(byte... array)

Allocates enough memory for the array and copies it.

Parameters:

array - the array to copy

See Also:

put(byte[])

BytePointer

public BytePointer(ByteBuffer buffer)

For direct buffers, calls Pointer.Pointer(Buffer), while for buffers backed with an array, allocates enough memory for the array and copies it.

Parameters:

buffer - the Buffer to reference or copy

See Also:

put(byte[])

BytePointer

public BytePointer(int size)

Allocates a native signed char array of the given size.

Parameters:

size - the number of signed char elements to allocate

BytePointer

public BytePointer()

See Also:

Pointer.Pointer()

BytePointer

public BytePointer(Pointer p)

See Also:

Pointer.Pointer(Pointer)

Method Detail

allocateArray

private void allocateArray(int size)

position

public BytePointer position(int position)

Description copied from class: Pointer

Sets the position and returns this. That makes the array.position(i) statement sort of equivalent to the array[i] statement in C++.

Overrides:

position in class Pointer

Parameters:

position - the new position

Returns:

this

See Also:

Pointer.position(int)

limit

public BytePointer limit(int limit)

Description copied from class: Pointer

Sets the limit and returns this. Used to limit the size of an operation on this object.

Overrides:

limit in class Pointer

Parameters:

limit - the new limit

Returns:

this

See Also:

Pointer.limit(int)

capacity

public BytePointer capacity(int capacity)

Description copied from class: Pointer

Sets the capacity and returns this. Should not be called more than once after allocation.

Overrides:

capacity in class Pointer

Parameters:

capacity - the new capacity

Returns:

this

See Also:

Pointer.capacity(int)

getStringBytes

public byte[] getStringBytes()

Returns:

the bytes from the null-terminated string

getString

public String getString(String charsetName)
                 throws UnsupportedEncodingException

Decodes the native bytes assuming they are encoded in the named charset.

Parameters:

charsetName - the charset in which the bytes are encoded

Returns:

a String from the null-terminated string

Throws:

UnsupportedEncodingException

getString

public String getString()

Decodes the native bytes assuming they are encoded in the platform's default charset.

Returns:

a String from the null-terminated string

putString

public BytePointer putString(String s,
                             String charsetName)
                      throws UnsupportedEncodingException

Encodes the String into the named charset and copies it in native memory, including a terminating null byte.

Parameters:

s - the String to encode and copy

charsetName - the charset in which to encode the bytes

Returns:

this

Throws:

UnsupportedEncodingException

See Also:

String.getBytes(String), put(byte[])

putString

public BytePointer putString(String s)

Encodes the String into the platform's default charset and copies it in native memory, including a terminating null byte.

Parameters:

s - the String to encode and copy

Returns:

this

See Also:

String.getBytes(), put(byte[])

get

public byte get()

Returns:

get(0)

get

public byte get(int i)

Returns:

the i-th byte value of a native array

put

public BytePointer put(byte b)

Returns:

put(0, b)

put

public BytePointer put(int i,
                       byte b)

Copies the byte value to the i-th element of a native array.

Parameters:

i - the index into the array

b - the byte value to copy

Returns:

this

get

public BytePointer get(byte[] array)

Returns:

get(array, 0, array.length)

put

public BytePointer put(byte... array)

Returns:

put(array, 0, array.length)

get

public BytePointer get(byte[] array,
                       int offset,
                       int length)

Reads a portion of the native array into a Java array.

Parameters:

array - the array to write to

offset - the offset into the array where to start writing

length - the length of data to read and write

Returns:

this

put

public BytePointer put(byte[] array,
                       int offset,
                       int length)

Writes a portion of a Java array into the native array.

Parameters:

array - the array to read from

offset - the offset into the array where to start reading

length - the length of data to read and write

Returns:

this

asBuffer

public final ByteBuffer asBuffer()

Description copied from class: Pointer

Same as Pointer.asByteBuffer(), but can be overridden to return subclasses of Buffer.

Overrides:

asBuffer in class Pointer

Returns:

asByteBuffer()

See Also:

asBuffer(), ShortPointer.asBuffer(), IntPointer.asBuffer(), LongPointer.asBuffer(), FloatPointer.asBuffer(), DoublePointer.asBuffer(), CharPointer.asBuffer()