com.mathworks.toolbox.javabuilder.MWStructArray 类

public abstract <T> T applyVisitor(AbstractMWArrayVisitor<T> v)

此方法是抽象的，返回由类型参数<T>指定的类型。它以 AbstractMWArrayVisitor<T> 的一个实例作为参量。此方法的目的是将访问者模式应用于 MWArray 对象。通过使用适当的访问者调用此方法，您可以以类型安全的方式遍历 MWArray 的元素并执行操作。

参数：

返回：

public MWClassID classID()

返回此数组的 MATLAB 类型。

参数：

返回：为 MWStructArray 返回 MWClassID.STRUCT。

示例：获取结构体数组的类 ID

创建 MWStructArray 对象并显示类 ID：

int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);
System.out.println("The class of S is " + S.classID());

The class of S is struct

public java.lang.Object clone() throws java.lang.CloneNotSupportedException

创建并返回此数组的深层副本。

示例：克隆结构体数组对象

创建一个 MWStructArray 对象，然后克隆该对象：

int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);
Object C = S.clone();
System.out.println("Clone of structure S is:");
System.out.println(C.toString());

Clone of structure S is:
1x2 struct array with fields:
	f1
	f2
	f3

返回：MWStructArray 实例表示底层 MATLAB 数组的深度复制。

抛出：

public int[] columnIndex()

返回一个数组，包含底层 MATLAB 数组中每个元素的列索引。

指定方：MWArray 类中的 columnIndex

返回：索引数组。

public int compareTo(java.lang.Object obj)

将此数组与指定数组进行比较以确定其顺序。

指定方：MWArray 类中的 compareTo

指定者： compareTo 类中的 java.lang.Comparable

参数：

public static MWArray deserialize(byte[] data)

从序列化数据创建一个新的 MWArray。

参数：

返回：反序列化的 MWArray。

public void dispose()

释放此数组包含的原生 MATLAB 数组。

指定者： Disposable 接口中的 dispose

指定方：MWArray 类中的 dispose

public boolean equals(java.lang.Object obj)

指示其他数组是否与此数组相等。

指定方：MWArray 类中的 equals

抛出：

public int fieldIndex(java.lang.String fieldname)

参数：

返回：给定字段名称的索引。

public java.lang.String[] fieldNames()

返回此数组中的字段名称。

参数：

返回：代表字段名称的字符串数组。

示例：获取结构体数组的字段名称

创建一个具有三个字段的 MWStructArray 对象并显示字段名称：

int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);

String[] str = S.fieldNames();

System.out.print("The structure has the fields: ");
  for (int i=0; i < S.numberOfFields(); i++)
     System.out.print(" " + str[i]);

The structure has the fields: f1 f2 f3

public static MWStructArray fromBean(java.lang.Object bean) throws java.beans.IntrospectionException, MWException

抛出：

public static MWStructArray fromMap(java.util.Map<java.lang.String,java.lang.Object> map) throws MWException

抛出：

public static MWStructArray fromProperties(java.util.Properties props)

public java.lang.Object get(int index)

返回此数组中指定从 1 开始的偏移量的元素。返回的元素使用默认转换规则转换为 Java^® 数组。调用此方法等效调用 getField(index).toArray()。

参数：

返回：包含所请求元素的对象。

抛出：

示例：使用 get 获取结构体数组数据

int[] cdims = {1, 3};
      MWStructArray C = new MWStructArray(cdims);
      Integer val = new Integer(15);
      int[] index2 = {1, 3};
      C.set(index2, val);
      Object x = C.get(index2);
      if (x instanceof int[][])
      {
       int[][] y = (int[][])x;
 		System.out.println("B: Cell data C(1,3) is " + y[0][0]);
      }

B: Cell data C(1,3) is 15

public java.lang.Object get(int[] index)

返回此数组中指定的基于 1 的索引数组处的元素。返回的元素使用默认转换规则转换为 Java 数组。调用此方法等效调用 getField(index).toArray()。

参数：

返回：包含所请求元素的对象。

抛出：

public java.lang.Object get(java.lang.String fieldname, int[] index)

返回此数组中指定的基于 1 的索引数组和字段名称处的元素。返回的元素使用默认转换规则转换为 Java 数组。调用此方法等效调用 getField(fieldname, index).toArray()。

参数：

返回：包含所请求元素的对象。

抛出：

public java.lang.Object get(java.lang.String fieldname, int index)

返回此数组中位于指定的以 1 为基础的偏移量和字段名称处的元素。返回的元素使用默认转换规则转换为 Java 数组。调用此方法等效调用 getField(fieldname, index).toArray()。

参数：

返回：包含所请求元素的对象。

抛出：

public java.lang.Object getData()

返回一个一维数组，其中包含底层 MATLAB 数组中数据的副本。

返回：按列顺序存储的元素的一维数组。转换之前，先通过将结构体数组转换为元胞数组来派生出一个新数组，这样，将具有 p 个字段的、大小为 m、... 的结构体数组转换为 ap、n、m、...元胞数组。通过在相应元胞上调用 MWArray.toArray() 将返回数组中的每个元素转换为 Java 数组。

示例：使用 getData 获取结构体数组数据

获取 MWStructArray 对象 S 的所有字段和索引中存储的数据：

int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);

int count = S.numberOfElements() * S.numberOfFields();

// Initialize the structure.
Integer[] val = new Integer[6];
for (int i = 0; i < count; i++)
   val[i] = new Integer((i+1) * 15);

// Use getData to get data from the structure.
System.out.println("Data read from structure array S: \n");
MWArray[] x = (MWArray[]) S.getData();
for (int i = 0; i < x.length; i++)
   System.out.print(" " + x[i]);

Data read from structure array S:

           15
           30
           45
           60
           75
           90

public int[] getDimensions()

返回此数组的维数。

返回：维度数。

public MWArray getField(int index)

将此数组中位于指定的基于 1 的偏移量的元素作为 MWArray 实例返回。

参数：

返回：代表所请求字段的 MWArray 实例。应通过调用 MWArray.dispose() 来处理此 MWArray 引用。

抛出：

public MWArray getField(int[] index)

将此数组中指定的基于 1 的索引数组处的元素的共享副本作为 MWArray 实例返回。

参数：

返回：代表所请求字段的 MWArray 实例。应通过调用 MWArray.dispose() 来处理此 MWArray 引用。

抛出：

public MWArray getField(java.lang.String fieldname, int[] index)

以 MWArray 实例的形式返回此数组中指定的基于 1 的索引数组和字段名称处的元素的共享副本。

参数：

返回：代表所请求字段的 MWArray 实例。应通过调用 MWArray.dispose() 来处理此 MWArray 引用。

抛出：

public MWArray getField(java.lang.String fieldname, int index)

将此数组中位于指定的基于 1 的偏移量和字段名称处的元素的共享副本作为 MWArray 实例返回。

参数：

返回：代表所请求字段的 MWArray 实例。应通过调用 MWArray.dispose() 来处理此 MWArray 引用。

抛出：

public int hashCode()

返回此数组的哈希码值。

由以下指定：hashCode 类中的 MWArray。

public boolean isEmpty()

测试此数组是否没有元素。

由以下指定：isEmpty 类中的 MWArray。

返回：如果为空则 true，否则 false

public boolean isSparse()

测试此数组是否稀疏。

由以下指定：MWArray 类中的 isSparse。

返回：如果为空则 true，否则 false

public int maximumNonZeros()

返回稀疏数组的分配容量。如果基础数组是非稀疏的，则此方法返回与 numberOfElements() 相同的值。

由以下指定：maximumNonZeros 类中的 MWArray。

返回：当前分配的稀疏数组中的非零元素的数量。

public int numberOfDimensions()

返回此数组的维数。

由以下指定：MWArray 类中的 numberOfDimensions。

返回：维数

public int numberOfElements()

返回此数组中元素的总数。

由以下指定：MWArray 类中的 numberOfElements。

返回：元素的数量

public int numberOfFields()

返回此数组中的字段数。

返回：该数组中的字段数量。

示例：获取结构体数组中的字段数

创建一个具有三个字段的 MWStructArray 对象并显示字段的数量：

 int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);

String[] str = S.fieldNames();

System.out.println("There are " + S.numberOfFields() +
    " fields in this structure.");

There are 3 fields in this structure.

public int numberOfNonZeros()

返回稀疏数组中非零元素的数量。如果基础数组是非稀疏的，则此方法返回与 numberOfElements() 相同的值。

由以下指定：MWArray 类中的 numberOfNonZeros。

返回：稀疏数组中当前非零元素的数量。

protected java.lang.Object readResolve() throws java.io.ObjectStreamException

从字节流加载新数组时由序列化机制调用。此方法验证正确的数组类型。

返回：返回此对象，指示已验证的数组类型。

抛出：

public int[] rowIndex()

返回一个数组，包含底层 MATLAB 数组中每个元素的行索引。

由以下指定：rowIndex 类中的 MWArray。

返回：索引数组。

public byte[] serialize() throws java.io.IOException

将 MATLAB 数组序列化为字节数组。

返回：序列化的 MATLAB 数组数据。

抛出：

public void set(int[] index, java.lang.Object element)

用指定元素替换此数组中指定的基于 1 的索引数组处的元素。

参数：

抛出：

public void set(java.lang.String fieldname, int[] index, java.lang.Object element)

用指定元素替换此数组中指定的基于 1 的索引数组和字段名称处的元素。

参数：

抛出：

public void set(java.lang.String fieldname, int[] index, java.lang.Object element)

用指定元素替换此数组中指定的基于 1 的索引数组和字段名称处的元素。

参数：

抛出：

public void set(java.lang.String fieldname, int index, java.lang.Object element)

用指定元素替换此数组中位于指定基于 1 的偏移量和字段名称处的元素。

参数：

抛出：

public void setData(java.lang.Object data)

由以下指定：setData 类中的 MWArray。

public java.lang.Object sharedCopy()

创建并返回此数组的一个共享副本。共享副本指向与原始数组相同的底层 MATLAB 数组。更改共享副本中的数据也会更改原始数组。

返回：一个 MWStructArray 实例，表示底层 MATLAB 数组的共享副本。

示例：创建结构体数组对象的共享副本

创建一个 MWStructArray 对象，然后创建一个该对象的共享副本：

int[]sdims={1,2};
String[]sfields={"f1","f2","f3"};
MWStructArrayS=newMWStructArray(sdims,sfields);

ObjectC=S.sharedCopy();

System.out.println("SharedcopyofstructureSis:");
System.out.println(C.toString());

Shared copy of structure S is:
      1x2 struct array with fields:
          f1
          f2
          f3

public java.lang.Object[] toArray()

返回一个数组，其中包含底层 MATLAB 数组中的数据副本。

返回：与 MATLAB 数组具有相同维度的数组。转换之前，先通过将结构体数组转换为元胞数组来派生出一个新数组，这样，将具有 p 个字段的、大小为 m、... 的结构体数组转换为 ap、n、m、...元胞数组。通过在相应的单元上调用 MWArray.toArray()，返回数组中的每个元素都会转换为 Java 数组。

示例：使用 toArray 获取结构体数组数据

int[] sdims = {1, 2};
String[] sfields = {"f1", "f2", "f3"};
MWStructArray S = new MWStructArray(sdims, sfields);

Integer[] val = new Integer[25];
for (int i = 0; i < 6; i++)
   val[i] = new Integer(i * 15);

for (int i = 0; i < 2; i++)
   for (int j = 0; j < sfields.length; j++)
S.set(sfields[j], i+1, val[j + (i * 3)]);

Object[][][] x = (Object[][][]) S.toArray();
System.out.println();

System.out.println("Data read from structure array S \n");
for (int j = 0; j < 2; j++)
   for (int i = 0; i < x.length; i++)
System.out.print(" " + ((int[][]) x[i][0][j])[0][0]);

Data read from structure array S

       0 15 30 45 60 75

public java.lang.String toString()

返回此数组的字符串表示形式。

由以下指定：MWArray 类中的 toString。

protected void validate()

验证内部数组句柄。由构造函数和反序列化代码调用。

public static void disposeArray(java.lang.Object obj)

此方法会销毁输入对象中包含的任何 MATLAB 原生数组并释放它们占用的内存。这是类的静态方法，因此不需要引用类的实例来调用。如果输入对象实现了 Disposable 接口，则通过调用其 Disposable.dispose() 方法来释放该对象。如果输入对象代表 Disposable 实例数组，则数组中的每个对象都会被处置。如果输入对象表示 java.lang.Object 数组或多维数组，则会递归处理该数组以释放数组中包含的每个 Disposable 实例。

示例：构造 MWNumericArray 对象

MWArray[] MArr = new MWArray[10];
for (int i = 0; i < 10; i++)
    MArr[i] = new MWNumericArray();
MWArray.disposeArray(MArr);

参数：

finalize()

当垃圾回收确定没有更多对此对象的引用时，由垃圾回收器对该对象调用。

public final Class<?> getClass()

返回此对象的运行时类。

public final void notify()

public final void notifyAll()

唤醒正在等待此对象的监视器的所有线程。

public final void wait(long timeout, int nanos) throws InterruptedException

使当前线程等待，直到另一个线程调用此对象的 notify() 方法或 notifyAll() 方法，或者某个其他线程中断当前线程，或者已经过了一定的实际时间。