SafeArray (JACOB : Java COM Bridge API Docs)

java.lang.Object
- com.jacob.com.JacobObject
- - com.jacob.com.SafeArray

```
public class SafeArray
extends JacobObject
```
This creates an array wrapper around Variant objects(?). This supports 1, 2 and n-dimensional arrays. It exists in this form because n-dimensional arrays were a later addition. (这将围绕Variant对象（？）创建一个数组包装器。这支持1、2和n维数组。它以这种形式存在是因为n维数组是后来的增加。)

Constructor Summary

Constructors
Constructor and Description
`SafeArray()` Constructor.
`SafeArray(int vt)` Constructor.
`SafeArray(int vt, int celems)` Constructor for a single dimensional array whose lower bounds is 0 and whose upper bound is specified as a parameter
`SafeArray(int vt, int[] lbounds, int[] celems)` Constructor with support for N-dimensional array support
`SafeArray(int vt, int celems1, int celems2)` Creates a two dimensional SafeArray whose base indexes are 0.
`SafeArray(String s)` Convert a string to a VT_UI1 array.

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`asString()` Convert a VT_UI1 array to string. (将VT_UI1数组转换为字符串。)
`Object`	`clone()`
`protected void`	`finalize()`
`void`	`fromBooleanArray(boolean[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromByteArray(byte[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromCharArray(char[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromDoubleArray(double[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromFloatArray(float[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromIntArray(int[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromLongArray(long[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromShortArray(short[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromStringArray(String[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`void`	`fromVariantArray(Variant[] ja)` populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
`boolean`	`getBoolean(int sa_idx)` boolean access (布尔访问)
`boolean`	`getBoolean(int[] indices)` get boolean value from N-dimensional array (从N维数组获取布尔值)
`boolean`	`getBoolean(int sa_idx1, int sa_idx2)` boolean access (布尔访问)
`void`	`getBooleans(int sa_idx, int nelems, boolean[] ja, int ja_start)` boolean access (布尔访问)
`byte`	`getByte(int sa_idx)` byte access (字节访问)
`byte`	`getByte(int[] indices)` get byte value from N-dimensional array (从N维数组获取字节值)
`byte`	`getByte(int sa_idx1, int sa_idx2)` byte access (字节访问)
`void`	`getBytes(int sa_idx, int nelems, byte[] ja, int ja_start)` Fills byte array from contents of this array (从该数组的内容填充字节数组)
`char`	`getChar(int sa_idx)` char access (字符访问)
`char`	`getChar(int[] indices)` get char value from N-dimensional array (从N维数组获取char值)
`char`	`getChar(int sa_idx1, int sa_idx2)` char access (字符访问)
`void`	`getChars(int sa_idx, int nelems, char[] ja, int ja_start)` char access (字符访问)
`double`	`getDouble(int sa_idx)` double access (双重访问)
`double`	`getDouble(int[] indices)` get double value from N-dimensional array (从N维数组中获取双精度值)
`double`	`getDouble(int sa_idx1, int sa_idx2)` double access (双重访问)
`void`	`getDoubles(int sa_idx, int nelems, double[] ja, int ja_start)` double access (双重访问)
`int`	`getElemSize()`
`int`	`getFeatures()`
`float`	`getFloat(int sa_idx)` float access (浮动访问)
`float`	`getFloat(int[] indices)` get float value from N-dimensional array (从N维数组获取浮点值)
`float`	`getFloat(int sa_idx1, int sa_idx2)` float access (浮动访问)
`void`	`getFloats(int sa_idx, int nelems, float[] ja, int ja_start)` float access (浮动访问)
`int`	`getInt(int sa_idx)` get int from an single dimensional array (从一维数组获取整数)
`int`	`getInt(int[] indices)` get int value from N-dimensional array (从N维数组获取整数值)
`int`	`getInt(int sa_idx1, int sa_idx2)` get int from 2 dimensional array (从二维数组获取整数)
`void`	`getInts(int sa_idx, int nelems, int[] ja, int ja_start)` retrieves a group of ints from a single dimensional array (从一维数组中检索一组整数)
`int`	`getLBound()`
`int`	`getLBound(int dim)`
`long`	`getLong(int sa_idx)` get int from an single dimensional array (从一维数组获取整数)
`long`	`getLong(int[] indices)` get long value from N-dimensional array (从N维数组中获取长值)
`long`	`getLong(int sa_idx1, int sa_idx2)` get long from 2 dimensional array (从二维数组变长)
`void`	`getLongs(int sa_idx, int nelems, long[] ja, int ja_start)` retrieves a group of longs from a single dimensional array (从一维数组中检索一组long)
`int`	`getNumDim()`
`int`	`getNumLocks()` not implemented. (未实现。)
`short`	`getShort(int sa_idx)` short access (短暂访问)
`short`	`getShort(int[] indices)` get short value from N-dimensional array (从N维数组中获取短值)
`short`	`getShort(int sa_idx1, int sa_idx2)` short access (短暂访问)
`void`	`getShorts(int sa_idx, int nelems, short[] ja, int ja_start)` short access (短暂访问)
`String`	`getString(int sa_idx)` string access (字符串访问)
`String`	`getString(int[] indices)` get String value from N-dimensional array (从N维数组获取字符串值)
`String`	`getString(int sa_idx1, int sa_idx2)` string access (字符串访问)
`void`	`getStrings(int sa_idx, int nelems, String[] ja, int ja_start)` string access (字符串访问)
`int`	`getUBound()`
`int`	`getUBound(int dim)`
`Variant`	`getVariant(int sa_idx)` variant access (变体访问)
`Variant`	`getVariant(int[] indices)` get Variant value from N-dimensional array (从N维数组获取Variant值)
`Variant`	`getVariant(int sa_idx1, int sa_idx2)` variant access (变体访问)
`void`	`getVariants(int sa_idx, int nelems, Variant[] ja, int ja_start)` variant access (变体访问)
`int`	`getvt()`
`protected void`	`init(int vt, int[] lbounds, int[] celems)`
`void`	`reinit(SafeArray sa)` Does anyone want to document this? (有人要记录吗？)
`void`	`reinterpretType(int vt)` Does anyone want to document this? (有人要记录吗？)
`void`	`safeRelease()` Finalizers call this method. (终结器调用此方法。)
`void`	`setBoolean(int[] indices, boolean c)` set boolean value in N-dimensional array (在N维数组中设置布尔值)
`void`	`setBoolean(int sa_idx, boolean c)` boolean access (布尔访问)
`void`	`setBoolean(int sa_idx1, int sa_idx2, boolean c)` boolean access (布尔访问)
`void`	`setBooleans(int sa_idx, int nelems, boolean[] ja, int ja_start)` boolean access (布尔访问)
`void`	`setByte(int[] indices, byte c)` set byte value in N-dimensional array (在N维数组中设置字节值)
`void`	`setByte(int sa_idx, byte c)` byte access (字节访问)
`void`	`setByte(int sa_idx1, int sa_idx2, byte c)` byte access (字节访问)
`void`	`setBytes(int sa_idx, int nelems, byte[] ja, int ja_start)` fills array with passed in bytes (用传入的字节填充数组)
`void`	`setChar(int[] indices, char c)` set char value in N-dimensional array (在N维数组中设置char值)
`void`	`setChar(int sa_idx, char c)` char access (字符访问)
`void`	`setChar(int sa_idx1, int sa_idx2, char c)` char access (字符访问)
`void`	`setChars(int sa_idx, int nelems, char[] ja, int ja_start)` char access (字符访问)
`void`	`setDouble(int[] indices, double c)` set double value in N-dimensional array (在N维数组中设置双精度值)
`void`	`setDouble(int sa_idx, double c)` double access (双重访问)
`void`	`setDouble(int sa_idx1, int sa_idx2, double c)` double access (双重访问)
`void`	`setDoubles(int sa_idx, int nelems, double[] ja, int ja_start)` double access (双重访问)
`void`	`setFloat(int[] indices, float c)` set float value in N-dimensional array (在N维数组中设置浮点值)
`void`	`setFloat(int sa_idx, float c)` float access (浮动访问)
`void`	`setFloat(int sa_idx1, int sa_idx2, float c)` float access (浮动访问)
`void`	`setFloats(int sa_idx, int nelems, float[] ja, int ja_start)` float access (浮动访问)
`void`	`setInt(int[] indices, int c)` set int value in N-dimensional array (在N维数组中设置int值)
`void`	`setInt(int sa_idx, int c)` sets the int value of an element in a single dimensional array (设置一维数组中元素的int值)
`void`	`setInt(int sa_idx1, int sa_idx2, int c)` sets the int value of a 2 dimensional array (设置二维数组的int值)
`void`	`setInts(int sa_idx, int nelems, int[] ja, int ja_start)` sets a group of ints into a single dimensional array (将一组整数设置为一维数组)
`void`	`setLong(int[] indices, long c)` set long value in N-dimensional array (在N维数组中设置long值)
`void`	`setLong(int sa_idx1, int sa_idx2, long c)` sets the long value of a 2 dimensional array (设置二维数组的long值)
`void`	`setLong(int sa_idx, long c)` sets the long value of an element in a single dimensional array (设置一维数组中元素的long值)
`void`	`setLongs(int sa_idx, int nelems, long[] ja, int ja_start)` sets a group of longs into a single dimensional array (将一组long设置为一维数组)
`void`	`setShort(int[] indices, short c)` set short value in N-dimensional array (在N维数组中设置短值)
`void`	`setShort(int sa_idx1, int sa_idx2, short c)` short access (短暂访问)
`void`	`setShort(int sa_idx, short c)` short access (短暂访问)
`void`	`setShorts(int sa_idx, int nelems, short[] ja, int ja_start)` short access (短暂访问)
`void`	`setString(int[] indices, String c)` set Stringvalue in N-dimensional array (在N维数组中设置Stringvalue)
`void`	`setString(int sa_idx1, int sa_idx2, String c)` puts a string into an element in a two dimensional array. (将字符串放入二维数组中的元素中。)
`void`	`setString(int sa_idx, String c)` puts a string into an element in a single dimensional safe array (将字符串放入一维安全数组中的元素)
`void`	`setStrings(int sa_idx, int nelems, String[] ja, int ja_start)` string access (字符串访问)
`void`	`setVariant(int[] indices, Variant v)` set Variant value in N-dimensional array (在N维数组中设置Variant值)
`void`	`setVariant(int sa_idx1, int sa_idx2, Variant c)` variant access (变体访问)
`void`	`setVariant(int sa_idx, Variant c)` variant access (变体访问)
`void`	`setVariants(int sa_idx, int nelems, Variant[] ja, int ja_start)` variant access (变体访问)
`boolean[]`	`toBooleanArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`byte[]`	`toByteArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`char[]`	`toCharArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`double[]`	`toDoubleArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`float[]`	`toFloatArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`int[]`	`toIntArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`long[]`	`toLongArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`short[]`	`toShortArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`String`	`toString()` Standard toString() Warning, this creates new Variant objects! (标准toString（）警告，这将创建新的Variant对象！)
`String[]`	`toStringArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
`Variant[]`	`toVariantArray()` Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)

Methods inherited from class com.jacob.com.JacobObject
debug, getBuildDate, getBuildVersion, isDebugEnabled

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - SafeArray
```
public SafeArray()
```
    Constructor. Why does this exist? Yeah, someone will post on sourceforge about this comment. (构造函数。为什么会存在？是的，有人会在sourceforge上发布有关此评论的信息。)
  - SafeArray
```
public SafeArray(int vt)
```
    Constructor. (构造函数。)
    
    Parameters:
    
    vt - type of array (-数组类型)
  - SafeArray
```
public SafeArray(int vt,
         int celems)
```
    Constructor for a single dimensional array whose lower bounds is 0 and whose upper bound is specified as a parameter (下限为0且上限指定为参数的一维数组的构造方法)
    
    Parameters:
    
    vt - type of the array (-数组的类型)
    
    celems - length of the array (-数组的长度)
  - SafeArray
```
public SafeArray(int vt,
         int celems1,
         int celems2)
```
    Creates a two dimensional SafeArray whose base indexes are 0. (创建其基本索引为0的二维SafeArray。)
    
    Parameters:
    
    vt - Type of the array (-数组类型)
    
    celems1 - length of the array in first dimension (-一维数组的长度)
    
    celems2 - length of the array in second dimension (-二维数组的长度)
  - SafeArray
```
public SafeArray(int vt,
         int[] lbounds,
         int[] celems)
```
    Constructor with support for N-dimensional array support
    You create an N-D SafeArray by: SafeArray sa = new SafeArray(Variant.VariantVariant, new int[] {0,0,0,0}, new int[] {4,4,4,4}); Where the 1st array is lower bounds and 2nd has the lengths of each dimension *
    (支持N维数组支持的构造方法您可以通过以下方式创建ND SafeArray：SafeArray sa = new SafeArray（Variant.VariantVariant，new int [] {0,0,0,0}，new int [] {4,4,4 ，4}）；其中第一个数组为下界，第二个数组为每个维的长度*)
    
    Parameters:
    
    vt - (-)
    
    lbounds - (-)
    
    celems - (-)
  - SafeArray
```
public SafeArray(String s)
```
    Convert a string to a VT_UI1 array. (将字符串转换为VT_UI1数组。)
    
    Parameters:
    
    s - source string (-源字符串)
- Method Detail
  - asString
```
public String asString()
```
    Convert a VT_UI1 array to string. Is this broken for unicode? (将VT_UI1数组转换为字符串。这对于unicode来说是坏的吗？)
    
    Returns:
    
    variant byte as a string (变体字节作为字符串)
  - clone
```
public Object clone()
```
    Overrides:
    
    clone in class Object
  - finalize
```
protected void finalize()
```
    Overrides:
    
    finalize in class Object
  - fromBooleanArray
```
public void fromBooleanArray(boolean[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromByteArray
```
public void fromByteArray(byte[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromCharArray
```
public void fromCharArray(char[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromDoubleArray
```
public void fromDoubleArray(double[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromFloatArray
```
public void fromFloatArray(float[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromIntArray
```
public void fromIntArray(int[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromLongArray
```
public void fromLongArray(long[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromShortArray
```
public void fromShortArray(short[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromStringArray
```
public void fromStringArray(String[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - fromVariantArray
```
public void fromVariantArray(Variant[] ja)
```
    populate the safe array from the passed in array of data (从传入的数据数组中填充安全数组)
    
    Parameters:
    
    ja - (-)
  - getBoolean
```
public boolean getBoolean(int sa_idx)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    boolean representation (布尔表示)
  - getBoolean
```
public boolean getBoolean(int[] indices)
```
    get boolean value from N-dimensional array (从N维数组获取布尔值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getBoolean
```
public boolean getBoolean(int sa_idx1,
                 int sa_idx2)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    boolean representation (布尔表示)
  - getBooleans
```
public void getBooleans(int sa_idx,
               int nelems,
               boolean[] ja,
               int ja_start)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getByte
```
public byte getByte(int sa_idx)
```
    byte access (字节访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    byte representaton (字节表示)
  - getByte
```
public byte getByte(int[] indices)
```
    get byte value from N-dimensional array (从N维数组获取字节值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getByte
```
public byte getByte(int sa_idx1,
           int sa_idx2)
```
    byte access (字节访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    byte representation (字节表示)
  - getBytes
```
public void getBytes(int sa_idx,
            int nelems,
            byte[] ja,
            int ja_start)
```
    Fills byte array from contents of this array (从该数组的内容填充字节数组)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getChar
```
public char getChar(int sa_idx)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    single character rpeesentation (单字符表示)
  - getChar
```
public char getChar(int[] indices)
```
    get char value from N-dimensional array (从N维数组获取char值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getChar
```
public char getChar(int sa_idx1,
           int sa_idx2)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    single character representation (单字符表示)
  - getChars
```
public void getChars(int sa_idx,
            int nelems,
            char[] ja,
            int ja_start)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getDouble
```
public double getDouble(int sa_idx)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    double stored in array (双重存储在数组中)
  - getDouble
```
public double getDouble(int[] indices)
```
    get double value from N-dimensional array (从N维数组中获取双精度值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getDouble
```
public double getDouble(int sa_idx1,
               int sa_idx2)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    double stored in array (双重存储在数组中)
  - getDoubles
```
public void getDoubles(int sa_idx,
              int nelems,
              double[] ja,
              int ja_start)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getElemSize
```
public int getElemSize()
```
    Returns:
    
    the size of each element? (每个元素的大小？)
  - getFeatures
```
public int getFeatures()
```
    Returns:
    
    The ??features of the array? (数组的功能？)
  - getFloat
```
public float getFloat(int sa_idx)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    float held in array at location (浮点数保持在数组中的位置)
  - getFloat
```
public float getFloat(int[] indices)
```
    get float value from N-dimensional array (从N维数组获取浮点值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getFloat
```
public float getFloat(int sa_idx1,
             int sa_idx2)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    float held in array at location (浮点数保持在数组中的位置)
  - getFloats
```
public void getFloats(int sa_idx,
             int nelems,
             float[] ja,
             int ja_start)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getInt
```
public int getInt(int sa_idx)
```
    get int from an single dimensional array (从一维数组获取整数)
    
    Parameters:
    
    sa_idx - array index (-数组索引)
    
    Returns:
    
    int stored in array (int存储在数组中)
  - getInt
```
public int getInt(int[] indices)
```
    get int value from N-dimensional array (从N维数组获取整数值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getInt
```
public int getInt(int sa_idx1,
         int sa_idx2)
```
    get int from 2 dimensional array (从二维数组获取整数)
    
    Parameters:
    
    sa_idx1 - array index first dimension (-数组索引第一维)
    
    sa_idx2 - array index of second dimension (-二维数组索引)
    
    Returns:
    
    int stored in array (int存储在数组中)
  - getInts
```
public void getInts(int sa_idx,
           int nelems,
           int[] ja,
           int ja_start)
```
    retrieves a group of ints from a single dimensional array (从一维数组中检索一组整数)
    
    Parameters:
    
    sa_idx - the index in the array to start the get (-数组中开始获取的索引)
    
    nelems - number of elements to retrieve (-要检索的元素数)
    
    ja - the structure to be filled with the ints (-要用整数填充的结构)
    
    ja_start - the start point in the java int array to start filling (-java int数组中的开始填充的起点)
  - getLong
```
public long getLong(int sa_idx)
```
    get int from an single dimensional array (从一维数组获取整数)
    
    Parameters:
    
    sa_idx - array index (-数组索引)
    
    Returns:
    
    long stored in array (长存储在数组中)
  - getLong
```
public long getLong(int[] indices)
```
    get long value from N-dimensional array (从N维数组中获取长值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getLong
```
public long getLong(int sa_idx1,
           int sa_idx2)
```
    get long from 2 dimensional array (从二维数组变长)
    
    Parameters:
    
    sa_idx1 - array index first dimension (-数组索引第一维)
    
    sa_idx2 - array index of second dimension (-二维数组索引)
    
    Returns:
    
    long stored in array (长存储在数组中)
  - getLongs
```
public void getLongs(int sa_idx,
            int nelems,
            long[] ja,
            int ja_start)
```
    retrieves a group of longs from a single dimensional array (从一维数组中检索一组long)
    
    Parameters:
    
    sa_idx - the index in the array to start the get (-数组中开始获取的索引)
    
    nelems - number of elements to retrieve (-要检索的元素数)
    
    ja - the structure to be filled with the longs (-填充多头的结构)
    
    ja_start - the start point in the java longs array to start filling (-Java long数组中开始填充的起点)
  - getLBound
```
public int getLBound()
```
    Returns:
    
    The lower bounds of the array? (数组的下限？)
  - getLBound
```
public int getLBound(int dim)
```
    Parameters:
    
    dim - the dimension we are checking in a multidimensional array (-我们在多维数组中检查的维度)
    
    Returns:
    
    The lower bounds of the array? (数组的下限？)
  - getNumDim
```
public int getNumDim()
```
    Returns:
    
    The number of dimensions in this array (此数组中的维数)
  - getNumLocks
```
public int getNumLocks()
```
    not implemented. (未实现。)
    
    Returns:
    
    0 (0)
  - getShort
```
public short getShort(int sa_idx)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    short stored in array (短存储在数组中)
  - getShort
```
public short getShort(int[] indices)
```
    get short value from N-dimensional array (从N维数组中获取短值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getShort
```
public short getShort(int sa_idx1,
             int sa_idx2)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    short stored in array (短存储在数组中)
  - getShorts
```
public void getShorts(int sa_idx,
             int nelems,
             short[] ja,
             int ja_start)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getString
```
public String getString(int sa_idx)
```
    string access (字符串访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    String stored in array (字符串存储在数组中)
  - getString
```
public String getString(int[] indices)
```
    get String value from N-dimensional array (从N维数组获取字符串值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getString
```
public String getString(int sa_idx1,
               int sa_idx2)
```
    string access (字符串访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    String stored in array (字符串存储在数组中)
  - getStrings
```
public void getStrings(int sa_idx,
              int nelems,
              String[] ja,
              int ja_start)
```
    string access (字符串访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getUBound
```
public int getUBound()
```
    Returns:
    
    The upper bounds of the array? (数组的上限？)
  - getUBound
```
public int getUBound(int dim)
```
    Parameters:
    
    dim - the dimension we are checking in a multidimensional array (-我们在多维数组中检查的维度)
    
    Returns:
    
    The upper bounds of the array? (数组的上限？)
  - getVariant
```
public Variant getVariant(int sa_idx)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx - (-)
    
    Returns:
    
    Variant held in location in the array? (阵列中是否放置了变体？)
  - getVariant
```
public Variant getVariant(int[] indices)
```
    get Variant value from N-dimensional array (从N维数组获取Variant值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    Returns:
    
    the value at the specified location (指定位置的值)
  - getVariant
```
public Variant getVariant(int sa_idx1,
                 int sa_idx2)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    Returns:
    
    Variant held in a location in the array? (在数组中的某个位置上有变体吗？)
  - getVariants
```
public void getVariants(int sa_idx,
               int nelems,
               Variant[] ja,
               int ja_start)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - getvt
```
public int getvt()
```
    Returns:
    
    the Variant type (变体类型)
  - init
```
protected void init(int vt,
        int[] lbounds,
        int[] celems)
```
  - reinit
```
public void reinit(SafeArray sa)
```
    Does anyone want to document this? (有人要记录吗？)
    
    Parameters:
    
    sa - (-)
  - reinterpretType
```
public void reinterpretType(int vt)
```
    Does anyone want to document this? (有人要记录吗？)
    
    Parameters:
    
    vt - the variant type? (-变体类型？)
  - safeRelease
```
public void safeRelease()
```
    Finalizers call this method. This method should release any COM data structures in a way that it can be called multiple times. This can happen if someone manually calls this and then a finalizer calls it. (终结器调用此方法。此方法应以可以多次调用的方式释放任何COM数据结构。如果有人手动调用它，然后终结器调用它，则会发生这种情况。)
    
    Overrides:
    
    safeRelease in class JacobObject
  - setBoolean
```
public void setBoolean(int sa_idx,
              boolean c)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setBoolean
```
public void setBoolean(int[] indices,
              boolean c)
```
    set boolean value in N-dimensional array (在N维数组中设置布尔值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setBoolean
```
public void setBoolean(int sa_idx1,
              int sa_idx2,
              boolean c)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setBooleans
```
public void setBooleans(int sa_idx,
               int nelems,
               boolean[] ja,
               int ja_start)
```
    boolean access (布尔访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setByte
```
public void setByte(int sa_idx,
           byte c)
```
    byte access (字节访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setByte
```
public void setByte(int[] indices,
           byte c)
```
    set byte value in N-dimensional array (在N维数组中设置字节值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setByte
```
public void setByte(int sa_idx1,
           int sa_idx2,
           byte c)
```
    byte access (字节访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setBytes
```
public void setBytes(int sa_idx,
            int nelems,
            byte[] ja,
            int ja_start)
```
    fills array with passed in bytes (用传入的字节填充数组)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setChar
```
public void setChar(int sa_idx,
           char c)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setChar
```
public void setChar(int[] indices,
           char c)
```
    set char value in N-dimensional array (在N维数组中设置char值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setChar
```
public void setChar(int sa_idx1,
           int sa_idx2,
           char c)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setChars
```
public void setChars(int sa_idx,
            int nelems,
            char[] ja,
            int ja_start)
```
    char access (字符访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setDouble
```
public void setDouble(int sa_idx,
             double c)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setDouble
```
public void setDouble(int[] indices,
             double c)
```
    set double value in N-dimensional array (在N维数组中设置双精度值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setDouble
```
public void setDouble(int sa_idx1,
             int sa_idx2,
             double c)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setDoubles
```
public void setDoubles(int sa_idx,
              int nelems,
              double[] ja,
              int ja_start)
```
    double access (双重访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setFloat
```
public void setFloat(int sa_idx,
            float c)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setFloat
```
public void setFloat(int[] indices,
            float c)
```
    set float value in N-dimensional array (在N维数组中设置浮点值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setFloat
```
public void setFloat(int sa_idx1,
            int sa_idx2,
            float c)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setFloats
```
public void setFloats(int sa_idx,
             int nelems,
             float[] ja,
             int ja_start)
```
    float access (浮动访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setInt
```
public void setInt(int sa_idx,
          int c)
```
    sets the int value of an element in a single dimensional array (设置一维数组中元素的int值)
    
    Parameters:
    
    sa_idx - index into the array (-索引到数组)
    
    c - the value to be set (-要设置的值)
  - setInt
```
public void setInt(int[] indices,
          int c)
```
    set int value in N-dimensional array (在N维数组中设置int值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setInt
```
public void setInt(int sa_idx1,
          int sa_idx2,
          int c)
```
    sets the int value of a 2 dimensional array (设置二维数组的int值)
    
    Parameters:
    
    sa_idx1 - index on the first dimension (-第一维索引)
    
    sa_idx2 - index on the second dimension (-二维索引)
    
    c - the value to be set (-要设置的值)
  - setInts
```
public void setInts(int sa_idx,
           int nelems,
           int[] ja,
           int ja_start)
```
    sets a group of ints into a single dimensional array (将一组整数设置为一维数组)
    
    Parameters:
    
    sa_idx - the index of the start of the array to put into (-要放入的数组开始的索引)
    
    nelems - number of elements to be copied (-要复制的元素数)
    
    ja - the new int values to be put into the array (-要放入数组中的新int值)
    
    ja_start - the start index in the array that we are copying into SafeArray (-我们要复制到SafeArray中的数组的起始索引)
  - setLong
```
public void setLong(int sa_idx,
           long c)
```
    sets the long value of an element in a single dimensional array (设置一维数组中元素的long值)
    
    Parameters:
    
    sa_idx - index into the array (-索引到数组)
    
    c - the value to be set (-要设置的值)
  - setLong
```
public void setLong(int[] indices,
           long c)
```
    set long value in N-dimensional array (在N维数组中设置long值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setLong
```
public void setLong(int sa_idx1,
           int sa_idx2,
           long c)
```
    sets the long value of a 2 dimensional array (设置二维数组的long值)
    
    Parameters:
    
    sa_idx1 - index on the first dimension (-第一维索引)
    
    sa_idx2 - index on the second dimension (-二维索引)
    
    c - the value to be set (-要设置的值)
  - setLongs
```
public void setLongs(int sa_idx,
            int nelems,
            long[] ja,
            int ja_start)
```
    sets a group of longs into a single dimensional array (将一组long设置为一维数组)
    
    Parameters:
    
    sa_idx - the index of the start of the array to put into (-要放入的数组开始的索引)
    
    nelems - number of elements to be copied (-要复制的元素数)
    
    ja - the new long values to be put into the array (-要放入数组中的新long值)
    
    ja_start - the start index in the array that we are copying into SafeArray (-我们要复制到SafeArray中的数组的起始索引)
  - setShort
```
public void setShort(int sa_idx1,
            int sa_idx2,
            short c)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setShort
```
public void setShort(int sa_idx,
            short c)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setShort
```
public void setShort(int[] indices,
            short c)
```
    set short value in N-dimensional array (在N维数组中设置短值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setShorts
```
public void setShorts(int sa_idx,
             int nelems,
             short[] ja,
             int ja_start)
```
    short access (短暂访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setString
```
public void setString(int sa_idx1,
             int sa_idx2,
             String c)
```
    puts a string into an element in a two dimensional array. (将字符串放入二维数组中的元素中。)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setString
```
public void setString(int sa_idx,
             String c)
```
    puts a string into an element in a single dimensional safe array (将字符串放入一维安全数组中的元素)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setString
```
public void setString(int[] indices,
             String c)
```
    set Stringvalue in N-dimensional array (在N维数组中设置Stringvalue)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    c - (-)
  - setStrings
```
public void setStrings(int sa_idx,
              int nelems,
              String[] ja,
              int ja_start)
```
    string access (字符串访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - setVariant
```
public void setVariant(int sa_idx1,
              int sa_idx2,
              Variant c)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx1 - (-)
    
    sa_idx2 - (-)
    
    c - (-)
  - setVariant
```
public void setVariant(int sa_idx,
              Variant c)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx - (-)
    
    c - (-)
  - setVariant
```
public void setVariant(int[] indices,
              Variant v)
```
    set Variant value in N-dimensional array (在N维数组中设置Variant值)
    
    Parameters:
    
    indices - - length must equal Dimension of SafeArray (--长度必须等于SafeArray的尺寸)
    
    v - (-)
  - setVariants
```
public void setVariants(int sa_idx,
               int nelems,
               Variant[] ja,
               int ja_start)
```
    variant access (变体访问)
    
    Parameters:
    
    sa_idx - (-)
    
    nelems - (-)
    
    ja - (-)
    
    ja_start - (-)
  - toBooleanArray
```
public boolean[] toBooleanArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    boolean[] array of booleans contained in this collection (boolean []此集合中包含的布尔数组)
  - toByteArray
```
public byte[] toByteArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    byte[] byte array contained in this collection (此集合中包含的byte []个字节数组)
  - toCharArray
```
public char[] toCharArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    char[] character array contained in this collection (此集合中包含的char []字符数组)
  - toDoubleArray
```
public double[] toDoubleArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    double[] double array contained in this collection (此集合中包含的double [] double数组)
  - toFloatArray
```
public float[] toFloatArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    float[] array of float contained in this collection (float []此集合中包含的float数组)
  - toIntArray
```
public int[] toIntArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    int[] int array contained in this collection (int []此集合中包含的int数组)
  - toLongArray
```
public long[] toLongArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    long[] long array contained in this collection (此集合中包含的long [] long数组)
  - toShortArray
```
public short[] toShortArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    short[] short array contained in this collection (short []此集合中包含的short数组)
  - toString
```
public String toString()
```
    Standard toString() Warning, this creates new Variant objects! (标准toString（）警告，这将创建新的Variant对象！)
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    String contents of variant (变体的字符串内容)
  - toStringArray
```
public String[] toStringArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    String[] String array contained in this collection (String []此集合中包含的字符串数组)
  - toVariantArray
```
public Variant[] toVariantArray()
```
    Retrieves the data from the array cast to a Java data type (从转换为Java数据类型的数组中检索数据)
    
    Returns:
    
    Variant[] array of variants contained in this collection (此集合中包含的Variant []变量数组)

Class SafeArray

Constructor Summary

Method Summary

Methods inherited from class com.jacob.com.JacobObject

Methods inherited from class java.lang.Object

Constructor Detail

SafeArray

SafeArray

SafeArray

SafeArray

SafeArray

SafeArray

Method Detail

asString

clone

finalize

fromBooleanArray

fromByteArray

fromCharArray

fromDoubleArray

fromFloatArray

fromIntArray

fromLongArray

fromShortArray

fromStringArray

fromVariantArray

getBoolean

getBoolean

getBoolean

getBooleans

getByte

getByte

getByte

getBytes

getChar

getChar

getChar

getChars

getDouble

getDouble

getDouble

getDoubles

getElemSize

getFeatures

getFloat

getFloat

getFloat

getFloats

getInt

getInt

getInt

getInts

getLong

getLong

getLong

getLongs

getLBound

getLBound

getNumDim

getNumLocks

getShort

getShort

getShort

getShorts

getString

getString

getString

getStrings

getUBound

getUBound

getVariant

getVariant

getVariant

getVariants

getvt

init

reinit

reinterpretType

safeRelease

setBoolean