J2Native

java.lang.Object
|
+--com.smardec.j2native.Argument
|
+--com.smardec.j2native.ZeroTerminatedString

All Implemented Interfaces:

java.lang.Cloneable, StringType

Direct Known Subclasses:

AnsiString, WideString

public abstract class ZeroTerminatedString

extends Argument

implements StringType

ZeroTerminatedString class is a base class for all types of zero-terminated strings.

NOTE: All string lengths include a terminating zero character unless otherwise noted.

Field Summary

Fields inherited from class com.smardec.j2native.Argument

JAVA_SIDE, NATIVE_SIDE

Constructor Summary
protected	ZeroTerminatedString(java.lang.String string) Constructs a string with specified value
protected	ZeroTerminatedString(java.lang.String string, int maxSize) Constructs a string with specified value and sets maximum chars quantity

Method Summary
protected abstract byte	getCharLength() Returns the character length
int	getLength() Additional info: due to every zero-terminated ends with zero value we add additional character to encode zero.
int	getMaxSize() Getter for string argument maximum size
java.lang.String	getValue() Getter for the string value of the argument
boolean	isAutoResize() Shows if string argument is autoresizeable.
protected boolean	isFixedLength() Identify if Argument is a fixed length variable.
protected void	read(long handle, int offset) Reads itself from the memory.
void	readFromStack(byte[] stack, int offset) Read itself from stack.
void	setAutoResize(boolean autoResize) Sets an auto resizeable property.
void	setMaxSize(int maxSize) Additional note: as autoResize property prevails to maxSize property, you have to set autoResize to false value before setting maxSize property.
void	setValue(java.lang.String value) Sets the value for the argument.
protected long	storeToRAM() Stores itself to the native memory.
protected void	write(long handle, int offset) Writes itself to the memory.
void	writeToStack(byte[] stack, int offset) Writes itself to stack.

Methods inherited from class com.smardec.j2native.Argument

clone, finalize, free, fromBytesValue, getAlignedLength, getResultFlags, readFromRAM, restoreFromRAM, toBytesValue, toBytesValue, update, writeToRAM

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ZeroTerminatedString
protected ZeroTerminatedString(java.lang.String string)

Constructs a string with specified value

Parameters:

string - the value to set.

Constructs a string with specified value and sets maximum chars quantity

Parameters:

string - the value to set.

maxSize - maximum size of the string argument in characters

Description copied from interface: StringType

Shows if string argument is autoresizeable. Autoresizeabe means that no string value length specified, and it could be any length

Specified by:

isAutoResize in interface StringType

Returns:

is auto resizeable

Description copied from interface: StringType

Sets an auto resizeable property.

Specified by:

setAutoResize in interface StringType

Parameters:

autoResize - autoresizeability

Description copied from interface: StringType

Getter for string argument maximum size

Specified by:

getMaxSize in interface StringType

Returns:

maximum size of the string argument

Additional note: as autoResize property prevails to maxSize property, you have to set autoResize to false value before setting maxSize property.

Specified by:

setMaxSize in interface StringType

Parameters:

maxSize - maximum size of the string argument