com.mathworks.toolbox.javabuilder.MWCharArray 类

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

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

参数：

返回：

public MWClassID classID()

返回此数组的 MATLAB 类型。

示例：获取字符数组的类 ID

Create an MWCharArray object and then display the class ID:
     char[] chArray1 = {'H', 'e', 'l', 'l', 'o'};
     MWCharArray A = new MWCharArray(chArray1);
 
     System.out.println("The class of A is " + A.classID());

The class of A is char

返回： MWClassID.CHAR 的 MWCharArray。

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

创建并返回此数组的深层副本。更改深层复制中的数据不会改变原始数组。

示例：克隆字符数组对象

创建 MWCharArray 对象 A 的克隆，如下所示：

char[] chArray = {'H', 'e', 'l', 'l', 'o'};
     MWCharArray A = new MWCharArray(chArray);
 
     Object C = A.clone();
 
     System.out.println("Clone of matrix A is:");
     System.out.println(C.toString());

Clone of matrix A is:
     Hello

抛出：

public int[] columnIndex()

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

指定者： columnIndex 类中的 MWArray

返回：索引数组。

public int compareTo(java.lang.Object obj)

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

指定者： compareTo 接口中的 java.lang.Comparable

指定者： compareTo 类中的 MWArray

参数：

public static MWArray deserialize(byte[] data)

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

参数：

返回：反序列化的 MWArray

public void dispose()

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

指定者： dispose 接口中的 Disposable

指定者： dispose 类中的 MWArray

public boolean equals(java.lang.Object obj)

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

指定者： equals 类中的 MWArray

参数：

public java.lang.Object get(int index)

返回此数组中指定从 1 开始的偏移量的元素。

指定者： get 类中的 MWArray

参数：

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

抛出：

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

返回此数组中指定的基于 1 的索引数组处的元素。

指定者： get 类中的 MWArray

参数：

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

抛出：

public char getChar(int index)

返回指定偏移量（以 1 为基数）处的字符。

参数：

返回：所请求元素的值。

抛出：

public char getChar(int[] index)

返回位于指定的基于 1 的索引数组处的字符。

示例：使用 getChar 获取字符数组数据

使用 getChar 显示存储在 MWCharArray 对象 A 中的字符串，如下所示：

char[] chArray = {'H', 'e', 'l', 'l', 'o'};
    MWCharArray A = new MWCharArray(chArray);
 
    for (int i = 1; i <= 5; i++)
       System.out.print(A.getChar(i));

Hello

参数：

返回：所请求元素的值。

抛出：

public java.lang.Object getData()

返回一个一维数组，其中包含底层 MATLAB 数组中数据的副本。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数类型，则 getData 返回实部。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 toArray。

指定者： MWArray 类中的 getData

返回：按列顺序存储的元素的一维数组。对于非稀疏数组，返回数组的长度等于 numberOfElements()；对于稀疏数组，返回数组的长度等于 numberOfNonZeros()。

public int[] getDimensions()

返回包含此数组每一维的大小的数组。

指定者： getDimensions 类中的 MWArray

返回：包含每个维度大小的数组

public int hashCode()

返回此数组的哈希码值。

指定者： hashCode 类中的 MWArray

public boolean isEmpty()

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

指定者： isEmpty 类中的 MWArray

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

public boolean isSparse()

测试此数组是否稀疏。

指定者： isSparse 类中的 MWArray

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

public int maximumNonZeros()

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

指定者： maximumNonZeros 类中的 MWArray

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

public static MWCharArray newInstance(int[] dims)

构造具有指定维度的字符数组。数组的元素全部初始化为 0。

示例：使用 newInstance 构造字符数组对象

创建一个包含文本 Hello 的 MWCharArray 对象：

 int[] dims = {1, 5};
     char[] chArray = {'H', 'e', 'l', 'l', 'o'};
     String str = new String(chArray);
 
     MWCharArray A =
         MWCharArray.newInstance(dims, str);
 
     System.out.println("The array string is \"" + A + "\"");

 The array string is "Hello"

参数：

返回：具有指定尺寸的新 MWCharArray。

抛出：

public static MWCharArray newInstance(int[] dims, java.lang.Object data)

构造具有指定维度的字符数组，并使用提供的数据初始化该数组。输入数组必须是 char[] 或 java.lang.String 类型。假定数组中的字符按列主顺序存储。

参数：

返回：一个具有指定尺寸并使用所提供数据初始化的新 MWCharArray。

抛出：

public int numberOfDimensions()

返回此数组的维数。

指定者： numberOfDimensions 类中的 MWArray

返回：维度数。

public int numberOfElements()

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

指定者： numberOfElements 类中的 MWArray

返回：元素的数量。

public int numberOfNonZeros()

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

指定者： numberOfNonZeros 类中的 MWArray

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

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

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

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

抛出：

public int[] rowIndex()

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

指定者： columnIndex 类中的 MWArray

返回：索引数组。

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

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

返回：序列化 MATLAB 数组数据

抛出：

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

用指定元素替换此数组中位于指定从 1 开始的偏移量的元素。

指定者： set 类中的 MWArray

参数：

抛出：

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

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

指定者： set 类中的 MWArray

参数：

抛出：

public void set(int index, char element)

用指定的 char 值替换此数组中指定的从 1 开始的偏移量的字符。

参数：

抛出：

public void set(int[] index, char element)

用指定的 char 值替换此数组中指定的基于 1 的索引数组处的字符。

示例：在字符数组中设置值

显示存储在 MWCharArray 对象 A 中的短语，更改其中一个字符，然后显示修改后的短语，如下所示：

char[] chArray = {'G', 'a', 'r', 'y'};
     MWCharArray A = new MWCharArray(chArray);
 
     System.out.println(" I think " + A + " lives here." + "\n");
 
     System.out.println("Changing the first character to M ...\n");
     int[] index = {1, 1};
     A.set(index, 'M');
 
     System.out.println(" I think " + A + " lives here." + "\n");

  I think Gary lives here.

  I think Mary lives here.

参数：

抛出：

public void setData(java.lang.Object data)

指定者： setData 类中的 MWArray

public java.lang.Object sharedCopy()

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

示例：创建字符数组对象的共享副本

创建 MWCharArray 对象 A 的共享副本，如下所示：

char[] chArray = {'H', 'e', 'l', 'l', 'o'};
MWCharArray A = new MWCharArray(chArray);
Object S = A.sharedCopy();
System.out.print("Shared copy of matrix A is \"" +
                          S.toString() + "\"");

Shared copy of matrix A is "Hello"

返回：MWCharArray 实例表示底层 MATLAB 数组的共享副本。

public java.lang.Object[] toArray()

返回一个包含底层 MATLAB 数组中数据副本的数组。返回的数组具有与底层 MATLAB 数组相同的维度。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数数值类型，则 toArray 返回实部。如果底层数组是稀疏的，则返回数组的完整表示。在具有较大行和列维度的稀疏数组上调用 toArray 时应小心，因为此操作可能会耗尽系统内存。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 toArray。

指定者： toArray 类中的 MWArray

返回：与 MATLAB 数组具有相同维数的数组。

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() 方法，或者某个其他线程中断当前线程，或者已经过了一定的实际时间。