oracle.sql

Interface VECTOR.SparseDoubleArray

All Superinterfaces:

VECTOR.SparseArray

Enclosing class:

VECTOR

public static interface VECTOR.SparseDoubleArray
extends VECTOR.SparseArray

A double-valued representation of SPARSE VECTOR data in Oracle Database. This interface is optimized for conversions of the FLOAT64 dimension type, but can also be used in conversions of the FLOAT32 and INT8 types.

Since:

23.7

Method Summary

Modifier and Type	Method and Description
static VECTOR.SparseDoubleArray	fromDenseArray(double[] denseArray) Creates a SparseDoubleArray that stores only the non-zero values of a double array.
static VECTOR.SparseDoubleArray	of(int length, int[] indices, double[] doubleValues) Creates a SparseDoubleArray of the given length, indices, and values.
double[]	values() Returns the non-zero values in the VECTOR data represented by this SparseDoubleArray.

Methods inherited from interface oracle.sql.VECTOR.SparseArray

indices, length, toString

Method Detail

values

double[] values()

Returns the non-zero values in the VECTOR data represented by this SparseDoubleArray. The values returned by this method appear at the indices returned by the VECTOR.SparseArray.indices() method.

The array returned by this method may be one that backs this SparseArray. Modifying the array's values can modify the set of non-zero values retained by this SparseArray.

Returns:

Non-zero values as an array of doubles. Not null.

of

static VECTOR.SparseDoubleArray of(int length,
                                   int[] indices,
                                   double[] doubleValues)

Creates a SparseDoubleArray of the given length, indices, and values. The arrays passed to this method are retained by the SparseDoubleArray. Modifying the values of these arrays will modify the indices and values retained by the SparseDoubleArray.

This method will only perform lightweight validations on the input. It will not validate the order or range of values in the indices array. These more extensive validations will occur when the SparseDoubleArray is set as a parameter in SQL executed by Oracle Database.

Parameters:

length - Total length of dimensions in the VECTOR, including zero-valued dimensions.

indices - Indices of non-zero values, ordered from least to greatest, in the range of 0 (inclusive) and the given length(exclusive). Not null.

doubleValues - Non-zero values appearing at each of the given indices. Not null.

Returns:

A SparseDoubleArray of the given length, indices, and values. Not null.

Throws:

java.lang.NullPointerException - If the indices or values are null.

java.lang.IllegalArgumentException - If the length is less than 0, or the indices or values have a length greater than 65535, or the indices and values have a different length.

fromDenseArray

static VECTOR.SparseDoubleArray fromDenseArray(double[] denseArray)

Creates a SparseDoubleArray that stores only the non-zero values of a double array.

Parameters:

denseArray - Array of double values, including zeros. Not null.

Returns:

A sparse array storing only the non-zero values of the dense array. Not null.

Throws:

java.lang.NullPointerException - If the denseArray is null.