MathWorks.MATLAB.NET.Arrays.MWCharArray 类

命名空间: MathWorks.MATLAB.NET.Arrays

MATLAB 字符数组的托管表示

全页展开

描述

MWCharArray 源自 MWArray，是 MATLAB 字符数组的托管表示。与 MATLAB 等效项一样，MWCharArray 提供对字符串创建和操作的支持。

线程安全

此类型的任何公共静态（在 Visual Basic 中为共享）成员都是线程安全的。任何实例成员都不能保证是线程安全的。

属性

全部展开

公共属性

`ArrayType` — `MWArray` 的派生类型
只读: `MWArrayType`

此属性为只读。

语法

public MWArrayType ArrayType { get; }

数组的派生类型，指定为 MWArrayType 对象。

`Dimensions` — 返回包含 `MWArray` 各维大小的本机整数数组
只读: 正整数

此属性为只读。

语法

public virtual int[] Dimensions { get; }

请参阅 size。

`Empty` — 返回空的 `MWCharArray` 的可写版本
只读: `MWCharArray`

此属性为只读。

语法

public static MWCharArray Empty { get; }

只读属性，返回包含 MWArray 各个维度大小的本机整数数组。（从 MWArray 继承。）

请参阅 size。

`IsCellArray` — 指示 `MWArray` 是否为 `MWCellArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsCellArray { get; }

请参阅 iscell。

`IsCharArray` — 指示 `MWArray` 是否为 `MWCharArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsCharArray { get; }

请参阅 ischar。

`IsDisposed` — 处理封装的 `MWArray` 的状态
只读: `boolean`

此属性为只读。

语法

public virtual bool IsDisposed { get; }

`IsEmpty` — 指示 `MWArray` 是否为空的标志
只读: `boolean`

此属性为只读。

语法

public virtual bool IsEmpty { get; }

请参阅 isempty。

`IsLogicalArray` — 指示 `MWArray` 是否为 `MWLogicalArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsLogicalArray { get; }

请参阅 islogical。

`IsNumericArray` — 指示 `MWArray` 是否为 `MWNumericArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsNumericArray { get; }

请参阅 isnumeric。

`IsStringArray` — 指示 `MWArray` 是否为 `MWStringArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsStringArray { get; }

请参阅 isstring。

`IsStructArray` — 指示 `MWArray` 是否为 `MWStructArray` 的标志
只读: `boolean`

此属性为只读。

语法

public bool IsStructArray { get; }

请参阅 isstruct。

`Item` — 通用 MATLAB 索引器以 `MWArray` 形式返回结果
`MWArray`

语法

public MWArray this[
	params int[] indices
] { get; set; }

索引可以是与数组维度相对应的任意数量的整数。与 MATLAB 一样，单个索引将返回数组中的第 n 个元素。注意：通用数组索引器支持数字、逻辑、字符和元胞数组类型。对于复杂的数字数组，将返回实部和虚组件。

与 MATLAB^® 一样，此 API 中的数组索引是从 1 开始的，而不是从 0 开始的。

`NativeGCBlockSize` — 非托管内存模块大小（以字节为单位）
只读: 正整数

此属性为只读。

语法

public static long NativeGCBlockSize { get; }

`NativeGCEnabled` — 原生数组 GC 启用标志
`boolean`

语法

public static bool NativeGCEnabled { get; set; }

如果启用了原生数组 GC，则 CLR 垃圾收集将根据需要透明地进行，以删除不再被引用的 MWArray 类或其派生类型的实例。这包括通过显式创建 MWArray 类型分配的非托管内存，以及通过隐式转换隐式实例化 MWArray。

`NumberOfDimensions` — `MWArray` 中的维数
只读: 正整数

此属性为只读。

语法

public int NumberofDimensions { get; }

请参阅 ndims。

`NumberOfElements` — `MWArray` 中的元素数量
只读: 正整数

此属性为只读。

语法

public int NumberOfElements { get; }

对于非空数组，等效于 prod(size(A))。请参阅 numel。

方法

全部展开

公共方法

`Clone`	语法 public virtual ObjectClone() 对 `MWArray` 进行深度复制。请参阅 MATLAB 文档中的 “=” 运算符。
`Dispose()`	语法 public void Dispose() 释放 `MWArray` 及其封装的本机 `mxArray` 的资源。此方法允许对 `MWArray` 及其原生 MATLAB 数组进行明确的生命周期控制。
`Equals`	语法 public override bool Equals( Objectobj ) 比较两个 `MWArray` 实例是否相等。如果两个数组相等，则返回 true。
`Finalize`	从 `Object` 继承
`GetHashCode`	语法 public override int GetHashCode() 返回 `MWArray` 的哈希码。
`GetObjectData`	语法 public virtual void GetObjectData( SerializationInfo info, StreamingContext context ) 参数 info 类型：System.Runtime.Serialization.SerializationInfo 保存序列化或反序列化对象所需的数据。 context 类型：System.Runtime.Serialization.StreamingContext 描述序列化流的源和目标。实现 ISerializable.GetObjectData(SerializationInfo, StreamingContext) 序列化函数。此函数的参量由 .NET 序列化基础结构提供。
`GetType`	从 `Object` 继承
`MemberwiseClone`	从 `Object` 继承
`ToArray`	语法 public virtual ArrayToArray() 返回一个本机 .NET 数组，其中包含底层 MATLAB 数组中的数据副本。返回的数组具有与底层 MATLAB 数组相同的维度。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数数值类型，`toArray` 将引发异常。如果底层数组是稀疏的，则返回数组的完整表示。在具有较大行和列维度的稀疏数组上调用 `toArray` 时应小心，因为此操作可能会耗尽系统内存。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 `toArray`。
`ToString`	语法 public virtual ArrayToString() 返回代表 `MWArray` 内容的格式化字符串
ToStringArrayIfIs2DArray	语法 public string[] ToStringArrayIfIs2DArray() 返回值类型：String[] .NET 字符串数组使用不需要将 ASCII 与 UTF16 相互转换的函数将 2D MWCharArray 转换为 .NET 字符串数组，以提高性能。

特殊运算符和函数

这些方法专门针对此类中的对象提供标准 MATLAB 运算符和函数。

Explicit(MWCharArray to Char

语法

public static explicit operator char (
	MWCharArray scalar
)

从 MATLAB MWCharArray 标量显式转换为本机字符值。

参数

stringArray

类型：System.Array

Implicit(String to MWCharArray)

语法

public static implicit operator MWCharArray (
	string value
)

从本机字符串隐式转换为 MATLAB 字符数组。

参数

value

类型：System.String

本机字符串。

返回值

类型：MWCharArray

表示字符串值的 MWCharArray。

本机字符串。

构造函数

这些方法专门针对此类中的对象提供标准 MATLAB 运算符和函数。

`MWCharArray()`	语法 public MWCharArray() 默认构造函数-创建一个空字符数组
`MWCharArray(Array)`	语法 public MWCharArray( Array stringArray ) 从字符串值原生数组构造一个 m×n×p×... 字符数组。参数 stringArray 类型：System.Array 本机字符串数组。字符数组将具有与本机字符串数组相同的维度。
`MWCharArray(Char)`	语法 public MWCharArray( char value ) 根据本机字符构造字符数组。参数 value 类型：System.Char 本机字符。
`MWCharArray(Char[])`	语法 public MWCharArray( char[] value ) 从本机字符数组构造一个字符数组。参数 value 类型：System.Char 本机字符数组。
`MWCharArray(Int32[])`	语法 public MWCharArray( params int[] dimensions ) 创建具有指定维度的空字符数组。参数 dimensions 类型：System.Int32[] 包含字符数组维数的整数数组。如果仅指定一个维度，则创建一个空的 n×n 字符数组。
`MWCharArray(String)`	语法 public MWCharArray( string value ) 从本机字符串构造字符数组。参数 value 类型：System.String 本机字符串。
`MWCharArray(String[])`	语法 public MWCharArray( string[] strings ) 从本机字符串数组构造一个字符数组。参数 value 类型：System.String[] 字符串参量的原生数组。
`MWCharArray(SerializationInfo, StreamingContext)`	语法 protected MWCharArray( SerializationInfo serializationInfo, StreamingContext context ) 内部反序列化构造函数。参数 serializationInfo 类型：System.Runtime.Serialization.SerializationInfo 保存序列化或反序列化对象所需的数据。 context 类型：System.Runtime.Serialization.StreamingContext 描述序列化流的源和目标此构造函数的参量由 .NET 序列化基础结构提供。

继承层次结构

System.Object

Mathworks.MATLAB.NET.Arrays.MWArray
- Mathworks.MATLAB.NET.Arrays.MWCellArray
- Mathworks.MATLAB.NET.Arrays.MWCharArray
- Mathworks.MATLAB.NET.Arrays.MWIndexArray
- Mathworks.MATLAB.NET.Arrays.MWObjectArray
- Mathworks.MATLAB.NET.Arrays.MWStringArray
- Mathworks.MATLAB.NET.Arrays.MWStructArray

版本历史记录

在 R2006a 中推出

MathWorks.MATLAB.NET.Arrays.MWCharArray 类

描述

属性

公共属性

ArrayType — MWArray 的派生类型 只读: MWArrayType

Dimensions — 返回包含 MWArray 各维大小的本机整数数组 只读: 正整数

Empty — 返回空的 MWCharArray 的可写版本 只读: MWCharArray

IsCellArray — 指示 MWArray 是否为 MWCellArray 的标志 只读: boolean

IsCharArray — 指示 MWArray 是否为 MWCharArray 的标志 只读: boolean

IsDisposed — 处理封装的 MWArray 的状态 只读: boolean

IsEmpty — 指示 MWArray 是否为空的标志 只读: boolean

IsLogicalArray — 指示 MWArray 是否为 MWLogicalArray 的标志 只读: boolean

IsNumericArray — 指示 MWArray 是否为 MWNumericArray 的标志 只读: boolean

IsStringArray — 指示 MWArray 是否为 MWStringArray 的标志 只读: boolean

IsStructArray — 指示 MWArray 是否为 MWStructArray 的标志 只读: boolean

Item — 通用 MATLAB 索引器以 MWArray 形式返回结果 MWArray

NativeGCBlockSize — 非托管内存模块大小（以字节为单位） 只读: 正整数

NativeGCEnabled — 原生数组 GC 启用标志 boolean

NumberOfDimensions — MWArray 中的维数 只读: 正整数

NumberOfElements — MWArray 中的元素数量 只读: 正整数

方法

公共方法

特殊运算符和函数

构造函数

继承层次结构

版本历史记录

`ArrayType` — `MWArray` 的派生类型
只读: `MWArrayType`

`Dimensions` — 返回包含 `MWArray` 各维大小的本机整数数组
只读: 正整数

`Empty` — 返回空的 `MWCharArray` 的可写版本
只读: `MWCharArray`

`IsCellArray` — 指示 `MWArray` 是否为 `MWCellArray` 的标志
只读: `boolean`

`IsCharArray` — 指示 `MWArray` 是否为 `MWCharArray` 的标志
只读: `boolean`

`IsDisposed` — 处理封装的 `MWArray` 的状态
只读: `boolean`

`IsEmpty` — 指示 `MWArray` 是否为空的标志
只读: `boolean`

`IsLogicalArray` — 指示 `MWArray` 是否为 `MWLogicalArray` 的标志
只读: `boolean`

`IsNumericArray` — 指示 `MWArray` 是否为 `MWNumericArray` 的标志
只读: `boolean`

`IsStringArray` — 指示 `MWArray` 是否为 `MWStringArray` 的标志
只读: `boolean`

`IsStructArray` — 指示 `MWArray` 是否为 `MWStructArray` 的标志
只读: `boolean`

`Item` — 通用 MATLAB 索引器以 `MWArray` 形式返回结果
`MWArray`

`NativeGCBlockSize` — 非托管内存模块大小（以字节为单位）
只读: 正整数

`NativeGCEnabled` — 原生数组 GC 启用标志
`boolean`

`NumberOfDimensions` — `MWArray` 中的维数
只读: 正整数

`NumberOfElements` — `MWArray` 中的元素数量
只读: 正整数