ValueArray class. More...

Public Member Functions
int[]	GetInteger (int index, int size)
	Get a subset of the Values from this int array.

long[]	GetTimestamp (int index, int size)
	Get a subset of the Values from this timestamp array.

void	Set (int index, com.sparsity.sparksee.gdb.Value value) throws System.ArgumentException, System.ApplicationException
	Set a Value to a specific array position.

void	SetBoolean (int index, bool[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this bool array.

void	SetTimestamp (long[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this timestamp array.

void	SetOID (long[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this oid array.

boolean	IsClosed ()
	Gets if ValueArray instance has been closed or not.

void	Get (int index, com.sparsity.sparksee.gdb.Value value) throws System.ArgumentException, System.ApplicationException
	Get a Value from the array.

void	SetTimestamp (int index, long[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this timestamp array.

long[]	GetOID ()
	Get all the Values from this OID array.

void	SetInteger (int index, int[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this int array.

long[]	GetLong (int index, int size)
	Get a subset of the Values from this long array.

bool[]	GetBoolean (int index, int size)
	Get a subset of the Values from this boolean array.

long[]	GetTimestamp ()
	Get all the Values from this timestamp array.

bool[]	GetBoolean ()
	Get all the Values from this boolean array.

void	SetBoolean (bool[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this bool array.

int[]	GetInteger ()
	Get all the Values from this int array.

double[]	GetDouble (int index, int size)
	Get a subset of the Values from this double array.

int	Size ()
	Returns the array size.

void	SetDouble (int index, double[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this double array.

void	MakeNull () throws System.ApplicationException
	Sets the attribute array to Null.

long[]	GetOID (int index, int size)
	Get a subset of the Values from this long array.

void	SetLong (int index, long[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this long array.

double[]	GetDouble ()
	Get all the Values from this double array.

void	SetOID (int index, long[] values) throws System.ApplicationException, System.ArgumentException, System.ApplicationException
	Set a subset of the values of this oid array.

void	SetLong (long[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this long array.

void	SetDouble (double[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this double array.

void	Close ()
	Closes the ValueArray instance.

void	SetInteger (int[] values) throws System.ApplicationException, System.ApplicationException
	Set all the values of this int array.

void	Set (com.sparsity.sparksee.gdb.Value value) throws System.ArgumentException, System.ApplicationException
	Set a Value to the whole array.

long[]	GetLong ()
	Get all the Values from this long array.

Detailed Description

ValueArray class.

It allows for getting and setting ValueArray attribute values.

It is very important to close the ValueArray once no more get or set operations will be performed.

Creation of a new ValueArray: (i) Set all the ValueArray elements using Graph::SetAttributeArray (ii) perform as many get/set operations as you need to the ValueArray instance. Lastly, (iii) Close the ValueArray

Use of an existing ValueArray: (i) Get a ValueArray instance using Graph::GetAttributeArray (ii) perform as many get/set operations as you need to the ValueArray instance. Lastly, (iii) Close the ValueArray

Check out the 'Attributes and values' section in the SPARKSEE User Manual for more details on this.

Author: Sparsity Technologies http://www.sparsity-technologies.com

Member Function Documentation

◆ Close()

void com.sparsity.sparksee.gdb.ValueArray.Close ( )

Closes the ValueArray instance.

It must be called to ensure the integrity of all data.

◆ Get()

void com.sparsity.sparksee.gdb.ValueArray.Get	(	int	index,
		com.sparsity.sparksee.gdb.Value	value ) throws System.ArgumentException, System.ApplicationException

Get a Value from the array.

AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the element to get [0..N-1]
value	[out] Value to get the array element

Exceptions

System.ArgumentException	If the index is out of range or the Value not valid
System.ApplicationException	null

◆ GetBoolean() [1/2]

bool[] com.sparsity.sparksee.gdb.ValueArray.GetBoolean ( )

Get all the Values from this boolean array.

Returns: Returns all the values

◆ GetBoolean() [2/2]

bool[] com.sparsity.sparksee.gdb.ValueArray.GetBoolean	(	int	index,
		int	size )

Get a subset of the Values from this boolean array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ GetDouble() [1/2]

double[] com.sparsity.sparksee.gdb.ValueArray.GetDouble ( )

Get all the Values from this double array.

Returns: Returns all the values

◆ GetDouble() [2/2]

double[] com.sparsity.sparksee.gdb.ValueArray.GetDouble	(	int	index,
		int	size )

Get a subset of the Values from this double array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ GetInteger() [1/2]

int[] com.sparsity.sparksee.gdb.ValueArray.GetInteger ( )

Get all the Values from this int array.

Returns: Returns all the values

◆ GetInteger() [2/2]

int[] com.sparsity.sparksee.gdb.ValueArray.GetInteger	(	int	index,
		int	size )

Get a subset of the Values from this int array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ GetLong() [1/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetLong ( )

Get all the Values from this long array.

Returns: Returns all the values

◆ GetLong() [2/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetLong	(	int	index,
		int	size )

Get a subset of the Values from this long array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ GetOID() [1/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetOID ( )

Get all the Values from this OID array.

Returns: Returns all the values

◆ GetOID() [2/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetOID	(	int	index,
		int	size )

Get a subset of the Values from this long array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ GetTimestamp() [1/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetTimestamp ( )

Get all the Values from this timestamp array.

Returns: Returns all the values

◆ GetTimestamp() [2/2]

long[] com.sparsity.sparksee.gdb.ValueArray.GetTimestamp	(	int	index,
		int	size )

Get a subset of the Values from this timestamp array.

Parameters

index	Position of the first element to get [0..N-1]
size	Number of elements to get [1..N]

Returns: Returns all the requested values

◆ IsClosed()

boolean com.sparsity.sparksee.gdb.ValueArray.IsClosed ( )

Gets if ValueArray instance has been closed or not.

See also: Close()

Returns: TRUE if the ValueArray instance has been closed, FALSE otherwise.

◆ MakeNull()

void com.sparsity.sparksee.gdb.ValueArray.MakeNull ( ) throws System.ApplicationException

Sets the attribute array to Null.

The ValueArray can not be used after this call.

Exceptions

System.ApplicationException null

◆ Set() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.Set ( com.sparsity.sparksee.gdb.Value value ) throws System.ArgumentException, System.ApplicationException

Set a Value to the whole array.

AppErrorIf the ValueArray is not available

Parameters

value [in] Value to set in all the array elements

Exceptions

System.ArgumentException	If the Value is not valid
System.ApplicationException	null

◆ Set() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.Set	(	int	index,
		com.sparsity.sparksee.gdb.Value	value ) throws System.ArgumentException, System.ApplicationException

Set a Value to a specific array position.

AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the element to set [0..N-1]
value	[in] Value to set in the array element

Exceptions

System.ArgumentException	If the index is out of range or the Value not valid
System.ApplicationException	null

◆ SetBoolean() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetBoolean ( bool[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this bool array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not bool

◆ SetBoolean() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetBoolean	(	int	index,
		bool[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this bool array.

UnsupportedOperationErrorIf array DataType is not bool AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetDouble() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetDouble ( double[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this double array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not Double

◆ SetDouble() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetDouble	(	int	index,
		double[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this double array.

UnsupportedOperationErrorIf array DataType is not Double AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetInteger() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetInteger	(	int	index,
		int[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this int array.

UnsupportedOperationErrorIf array DataType is not int AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetInteger() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetInteger ( int[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this int array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not int

◆ SetLong() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetLong	(	int	index,
		long[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this long array.

UnsupportedOperationErrorIf array DataType is not long AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetLong() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetLong ( long[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this long array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not long

◆ SetOID() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetOID	(	int	index,
		long[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this oid array.

UnsupportedOperationErrorIf array DataType is not oid AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetOID() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetOID ( long[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this oid array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not oid

◆ SetTimestamp() [1/2]

void com.sparsity.sparksee.gdb.ValueArray.SetTimestamp	(	int	index,
		long[]	values ) throws System.ApplicationException, System.ArgumentException, System.ApplicationException

Set a subset of the values of this timestamp array.

UnsupportedOperationErrorIf array DataType is not timestamp AppErrorIf the ValueArray is not available

Parameters

index	[in] Position of the first element to set [0..N-1]
values	The values to set

Exceptions

System.ApplicationException	null
System.ArgumentException	If the index or size is out of range
System.ApplicationException	null

◆ SetTimestamp() [2/2]

void com.sparsity.sparksee.gdb.ValueArray.SetTimestamp ( long[] values ) throws System.ApplicationException, System.ApplicationException

Set all the values of this timestamp array.

AppErrorIf the ValueArray is not available

Parameters

values All the values to set

Exceptions

System.ApplicationException	null
System.ApplicationException	If array DataType is not timestamp

◆ Size()

int com.sparsity.sparksee.gdb.ValueArray.Size ( )

Returns the array size.

Returns: The number of elements in the array.

Public Member Functions

Detailed Description

Member Function Documentation

◆ Close()

◆ Get()

◆ GetBoolean() [1/2]

◆ GetBoolean() [2/2]

◆ GetDouble() [1/2]

◆ GetDouble() [2/2]

◆ GetInteger() [1/2]

◆ GetInteger() [2/2]

◆ GetLong() [1/2]

◆ GetLong() [2/2]

◆ GetOID() [1/2]

◆ GetOID() [2/2]

◆ GetTimestamp() [1/2]

◆ GetTimestamp() [2/2]

◆ IsClosed()

◆ MakeNull()

◆ Set() [1/2]

◆ Set() [2/2]

◆ SetBoolean() [1/2]

◆ SetBoolean() [2/2]

◆ SetDouble() [1/2]

◆ SetDouble() [2/2]

◆ SetInteger() [1/2]

◆ SetInteger() [2/2]

◆ SetLong() [1/2]

◆ SetLong() [2/2]

◆ SetOID() [1/2]

◆ SetOID() [2/2]

◆ SetTimestamp() [1/2]

◆ SetTimestamp() [2/2]

◆ Size()