Microsoft SDK for Java

getFloat

The getFloat method of the SafeArray Class contains the following signatures:

getFloat(int sa_idx)
getFloat(int sa_idx1, int sa_idx2)

getFloat(int sa_idx)

Extracts an element of a one-dimensional SafeArray as a float.

Syntax

public native float getFloat(int sa_idx);

Return Value

Returns the converted element value.

Parameters

sa_idx The element index, which ranges from the index of the lower bound to the index of the upper bound.

Exceptions

IndexOutOfBoundsException if the array is not one-dimensional or if sa_idx lies outside the defined range (LBound()..UBound()).

ClassCastException if the SafeArray element cannot be converted to the correct type by using the Win32 VariantChangeType function.

getFloat(int sa_idx1, int sa_idx2)

This method of the SafeArray Class extracts an element of a two-dimensional SafeArray as a float.

Syntax

public float getFloat(int sa_idx1, int sa_idx2);

Return Value

Returns the converted element value.

Parameters

sa_idx1 The first dimension index of the element that is extracted, which ranges from LBound(1) to UBound(1).
sa_idx2 The second dimension index of the element that is extracted, which ranges from LBound(2) to UBound(2).

Exceptions

IndexOutOfBoundsException if the SafeArray is not two-dimensional or if either index lies outside the defined range.

ClassCastException if the SafeArray element cannot be converted to the correct type by using the Win32 VariantChangeType function.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.