MathWorks.MATLAB.NET.Arrays.MWNumericArray 类

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

MATLAB 数字数组类型的托管表示

全页展开

描述

MWNumericArray 是 MATLAB 数字数组类型的托管表示。与其 MATLAB 等效项一样，它是大多数 MATLAB 数学函数使用的默认数组类型。

线程安全

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

属性

全部展开

公共属性

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

此属性为只读。

语法

public MWArrayType ArrayType { get; }

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

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

此属性为只读。

语法

public virtual int[] Dimensions { get; }

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

此属性为只读。

语法

public static MWNumericArray Empty { get; }

请参阅 size。

`FloatingPointAccuracy` — 返回从 1.0 到下一个最大浮点数的距离
只读: 双精度

此属性为只读。

语法

public static double FloatingPointAccuracy { get; }

请参阅 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。

方法

全部展开

构造函数

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

`MWNumericArray()`	创建一个空的双精度数值数组。
`MWNumericArray(Array)`	按行主顺序从本机矩形数组创建一个 m×n×p×... 实双数值数组。数字数组将具有与用户指定的数据数组相同的形状。如果输入数组是交错数组，则创建一个 m×n×p×... 数字数组，其类型与交错数组的元素类型相同。如果锯齿数组不具有矩形形状，则抛出。
`MWNumericArray(Byte)`	根据字节值创建一个双精度数值标量。
`MWNumericArray(Double)`	根据双精度值构造双精度数值标量。
`MWNumericArray(Int16)`	根据短值创建一个双精度数值标量。
`MWNumericArray(Int32)`	根据整数值创建一个双精度数值标量。
`MWNumericArray(Int32[])`	创建一个 m×n×p×... 的空实数双数值数组，并初始化为零。
`MWNumericArray(Int64)`	根据长整型值创建一个双精度数值标量。
`MWNumericArray(Single)`	从浮点值创建 MATLAB 双精度数值标量。
`MWNumericArray(MWNumericType)`	创建指定类型的空数字数组。
`MWNumericArray(Array, Array)`	按行主顺序从实数和虚数原生数组创建一个 m×n×p×... 复数数值数组。数字数组将具有与用户指定的数据数组相同的形状。
`MWNumericArray(Byte, Boolean)`	从字节值创建一个 uint8 数字标量。
`MWNumericArray(Byte, Byte)`	根据实数和虚数字节值创建一个复数双精度数值标量。
`MWNumericArray(Double, Double)`	根据实数和虚数双精度值构造一个复数双精度数值标量。
`MWNumericArray(Int16, Boolean)`	从短值创建一个 int16 数字标量。
`MWNumericArray(Int16, Int16)`	根据实数和虚数短值创建一个复数双精度数值标量。
`MWNumericArray(Int32, Boolean)`	从整数值创建一个 int32 数字标量。
`MWNumericArray(Int32, Int32)`	根据实数和虚数整数值创建一个复数双精度数值标量。
`MWNumericArray(Int64, Boolean)`	从长整型值创建一个 int64 数字标量。
`MWNumericArray(Int64, Int64)`	根据实数和虚数 long 值创建一个复数双精度数值标量。
`MWNumericArray(SerializationInfo, StreamingContext)`	内部反序列化构造函数。
`MWNumericArray(Single, Boolean)`	从浮点值创建浮点数值标量。
`MWNumericArray(Single, Single)`	根据实数和虚数浮点值创建一个复数双精度数值标量。
`MWNumericArray(MWArrayComplexity,Int32[])`	创建一个 m×n×p×... 的空双精度数值数组，并将其初始化为零。
`MWNumericArray(Array, Boolean, Boolean)`	按行主顺序从原生数组创建一个 m×n×p×... 实数数组。数字数组将具有与用户指定的数据数组相同的形状。
`MWNumericArray(Byte, Byte, Boolean)`	根据实数和虚数字节值创建一个复杂的 uint8 数字标量。
`MWNumericArray(Int16, Int16, Boolean)`	根据实数和虚数短值创建一个复数 int16 数字标量。
`MWNumericArray(Int32, Int32, Boolean)`	根据实数和虚数整数值构造一个复数 int32 数值标量。
`MWNumericArray(Int32, Int32,Byte[])`	按行主顺序从字节值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Double[])`	按行主顺序从双精度值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Int16[])`	按行主顺序从短值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Int32[])`	根据按行主顺序排列的整数值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Int64[])`	按行主顺序从长整型值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Single[])`	按行主顺序从浮点值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int64, Int64, Boolean)`	根据实数和虚数 long 值创建一个复数 int64 数字标量。
`MWNumericArray(Single, Single, Boolean)`	根据实数和虚数浮点值创建一个复数浮点数值标量。
`MWNumericArray(MWArrayComplexity, MWNumericType,Int32[])`	创建一个 m×n×p×... 的空数字数组，并将其初始化为零。
`MWNumericArray(Array, Array, Boolean, Boolean)`	根据实数和虚数原生数组按行主顺序创建指定类型的 m×n×p×... 复数数值数组。数字数组将具有与用户指定的数据数组相同的形状。
`MWNumericArray(Int32, Int32,Byte[],Byte[])`	按行主顺序从字节值的实数和虚数向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Double[], Boolean)`	根据双精度值的本机向量创建一个 m×n 双精度数组。
`MWNumericArray(Int32, Int32,Double[],Double[])`	按行主顺序，根据双精度值的实数和虚数向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Int16[],Int16[])`	按行主顺序，根据实数和虚数短值向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Int32[],Int32[])`	根据按行主顺序排列的整数值的实数和虚数向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Int64[],Int64[])`	按行主顺序，根据长整型值的实数和虚数向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Single[],Single[])`	按行主顺序从浮点值的实数和虚数向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Byte[], Boolean, Boolean)`	从字节值的本机向量创建一个 m×n uint8 数组。
`MWNumericArray(Int32, Int32,Double[],Double[], Boolean)`	根据双精度值的本机向量创建一个 m×n 复数双精度数组。
`MWNumericArray(Int32, Int32,Int16[], Boolean, Boolean)`	从本机短值向量创建一个 m×n int16 数组。
`MWNumericArray(Int32, Int32,Int32[], Boolean, Boolean)`	从整数值的本机向量创建一个 m×n int32 数组。
`MWNumericArray(Int32, Int32,Int64[], Boolean, Boolean)`	从长整型值的本机向量创建一个 m×n 的 int64 数组。
`MWNumericArray(Int32, Int32,Single[], Boolean, Boolean)`	从浮点值的本机向量构造一个 m×n 浮点数数组。
`MWNumericArray(Int32, Int32,Byte[],Byte[], Boolean, Boolean)`	从字节值的本机向量创建一个 m×n 复数 uint8 数组。
`MWNumericArray(Int32, Int32,Int16[],Int16[], Boolean, Boolean)`	根据本机短值向量创建一个 m×n 复数 int16 数组。
`MWNumericArray(Int32, Int32,Int32[],Int32[], Boolean, Boolean)`	根据整数值的本机向量创建一个 m×n 复数 int32 数组。
`MWNumericArray(Int32, Int32,Int64[],Int64[], Boolean, Boolean)`	根据长整型值的本机向量创建一个 m×n 复数 int64 数组。
`MWNumericArray(Int32, Int32,Single[],Single[], Boolean, Boolean)`	从浮点值的本机向量创建一个 m×n 复数浮点数数组。

公共方法

`array_handle_imag`	内部函数
`array_handle_real`	内部函数
`Clone`	语法 publicvirtualObjectClone() 对 `MWArray` 进行深度复制。请参阅 MATLAB 文档中的 “=” 运算符。
`ConvertToNativeTypes`	语法 publicstaticObject[] ConvertToNativeTypes( MWArray[] src, Type[] specifiedTypes ) 将 `MWArray` 数组转换为用户指定的类型。如果成功则返回具有转换类型的对象数组，否则抛出 `ArgumentException`。此方法只能从生成的实现中调用。
`Dispose()`	语法 publicvoidDispose() 释放 `MWArray` 及其封装的本机 `mxArray` 的资源。此方法允许对 `MWArray` 及其原生 MATLAB 数组进行明确的生命周期控制。
`Dispose(Boolean)`	语法 protected override void Dispose( bool disposing ) 参数 disposing 类型：System.Boolean 客户端显式处置标志内部处理函数
`Equals`	语法 publicoverrideboolEquals( Objectobj ) 比较两个 `MWArray` 实例是否相等。如果两个数组相等，则返回 true。
`Finalize`	从 `Object` 继承
`GetHashCode`	语法 publicoverrideintGetHashCode() 返回 `MWArray` 的哈希码。
`GetObjectData`	语法 publicvirtualvoidGetObjectData( SerializationInfoinfo, StreamingContextcontext ) 参数 info 类型：System.Runtime.Serialization.SerializationInfo 保存序列化或反序列化对象所需的数据。 context 类型：System.Runtime.Serialization.StreamingContext 描述序列化流的源和目标。实现 ISerializable.GetObjectData(SerializationInfo, StreamingContext) 序列化函数。此函数的参量由 .NET 序列化基础结构提供。
`GetType`	从 `Object` 继承
`MakeSparse(Int32[], Int32[], Double[])`	构造一个实稀疏数值矩阵，其行数 = max{rowIndex(k)}，列数 = max{colIndex(k)}。它使用提供的数据初始化数组。非零元素的最大数量等于数据数组的长度。
`MakeSparse(Int32,Int32,MWArrayComplexity, Int32)`	构造一个具有指定行数和列数以及指定非零元素数量的存储空间的空稀疏数字矩阵。
`MakeSparse(Int32[], Int32[],Double[],Double[])`	构造一个复杂稀疏数值矩阵，其行数 = max{rowIndex(k)}，列数 = max{colIndex(k)}。它使用提供的数据初始化数组。非零元素的最大数量等于数据数组的长度。
`MakeSparse(Int32, Int32,Int32[],Int32[],Double[])`	构造具有指定行数和列数的实稀疏数字矩阵。它使用提供的数据初始化数组。
`MakeSparse(Int32, Int32, Int32[], Int32[], Double[], Double[])`	构造具有指定行数和列数的复杂稀疏数字矩阵。它使用提供的数据初始化数组。
`MakeSparse(Int32, Int32, Int32[],Int32[],Double[], Int32)`	构造具有指定行数和列数以及最大非零元素数的实稀疏数值矩阵。它使用提供的数据初始化数组。
`MakeSparse(Int32, Int32,Int32[],Int32[],Double[], Double[], Int32)`	构造具有指定行数和列数以及最大非零元素数的复杂稀疏数值矩阵。它使用提供的数据初始化数组。
`MemberwiseClone`	从 `Object` 继承
`ToArray`	语法 public virtual Array ToArray() 返回一个本机 .NET 数组，其中包含底层 MATLAB 数组中的数据副本。返回的数组具有与底层 MATLAB 数组相同的维度。返回数组的元素按照默认转换规则进行转换。如果底层 MATLAB 数组是复数数值类型，`toArray` 将引发异常。如果底层数组是稀疏的，则返回数组的完整表示。在具有较大行和列维度的稀疏数组上调用 `toArray` 时应小心，因为此操作可能会耗尽系统内存。如果底层数组是元胞或结构体数组，则在每个元胞上递归调用 `toArray`。
`ToArray(MWArrayComponent)`	语法 public Array ToArray( MWArrayComponentcomponent ) component 类型：MathWorks.MATLAB.Arrays.MWArrayComponent 指示要返回的数组组件的标志。返回值类型：数组包含数值数组请求组件的 MATLAB 数值数组该方法按列主顺序返回数组组件的副本。数组元素的类型由数值数组的数据类型决定。
`ToEmptyVector`	将空的 MATLAB 数值向量作为适当类型的原生数组返回。
`ToScalarByte`	将 MATLAB uint8 数字标量转换为字节值
`ToScalarDouble`	将 MATLAB 双精度数值标量转换为双精度值。
`ToScalarFloat`	将 MATLAB 单个数值标量转换为浮点值。
`ToScalarInteger`	将 MATLAB int32 数字标量转换为整数值。
`ToScalarLong`	将 MATLAB int64 数字标量转换为长整型值。
`ToScalarShort`	将 MATLAB int16 数字标量转换为短值。
`ToString`	语法 public virtual string ToString() 返回代表 `MWArray` 内容的格式化字符串
`ToVector`	语法 public Array ToVector( MWArrayComponent component ) component 类型：MathWorks.MATLAB.Arrays.MWArrayComponent 指示要返回的数组组件的标志。返回值类型：数组包含数值数组请求组件的 MATLAB 数值数组以原生数组的形式返回 MATLAB 数值数组的请求（实部/虚部）组件。该方法按列主顺序返回数组组件的副本。数组元素的类型由数值数组的数据类型决定。

特殊运算符和函数

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

`Explicit(MWNumericArray to Byte)`	从 MATLAB uint8 数字标量隐式转换为字节值。
`Explicit(MWNumericArray to Int16)`	从 MATLAB Int16 数字标量隐式转换为短值。
`Explicit(MWNumericArray to Int32)`	从 MATLAB Int32 数字标量隐式转换为整数值。
`Explicit(MWNumericArray to Int64)`	从 MATLAB Int64 数字标量隐式转换为长值。
`Explicit(MWNumericArray to Single)`	从 MATLAB 单个数值标量隐式转换为浮点值。
`Explicit(MWNumericArray to Double)`	从 MATLAB 双精度数值标量隐式转换为双精度值。
`Implicit(Array to MWNumericArray)`	从通用原生数组隐式转换为相同数值类型的 MATLAB 数字数组。
`Implicit(Byte to MWNumericArray)`	从本机字节值隐式转换为 MATLAB uint8 数字标量。
`Implicit(Byte[] to MWNumericArray)`	从一维字节值原生数组隐式转换为 MATLAB uint8 实数数组。
`Implicit(Double to MWNumericArray)`	从本机双精度标量隐式转换为 MATLAB 双精度数值标量。
`Implicit(Double[] to MWNumericArray)`	从一维双精度值原生数组隐式转换为 MATLAB 双精度实数数组。
`Implicit(Int16 to MWNumericArray)`	从本机短值隐式转换为 MATLAB int16 数字标量。
`Implicit(Int16[] to MWNumericArray)`	从一维短值原生数组隐式转换为 MATLAB Int16 实数数组。
`Implicit(Int32 to MWNumericArray)`	从本机整数标量隐式转换为 MATLAB 双数值标量。
`Implicit(Int32[] to MWNumericArray)`	从一维整数值原生数组隐式转换为 MATLAB 双实数数组。
`Implicit(Int64 to MWNumericArray)`	从本机长标量隐式转换为 MATLAB Int64 数字标量。
`Implicit(Int64[] to MWNumericArray)`	从一维长值原生数组隐式转换为 MATLAB Int64 实数数组。
`Implicit(Single to MWNumericArray)`	从本机浮点标量隐式转换为 MATLAB 单个数值标量。
`Implicit(Single[] to MWNumericArray)`	从一维浮点值原生数组隐式转换为 MATLAB 单个实数数组。

字段

`Inf`	表示无穷大的 MATLAB 数字数组常量。
`NaN`	MATLAB 数字数组常量代表非数字。

继承层次结构

System.Object

Mathworks.MATLAB.NET.Arrays.MWArray
- Mathworks.MATLAB.NET.Arrays.MWIndexArray
  - Mathworks.MATLAB.NET.Arrays.MWLogicalArray
  - Mathworks.MATLAB.NET.Arrays.MWNumericArray

版本历史记录

在 R2006a 中推出

MathWorks.MATLAB.NET.Arrays.MWNumericArray 类

描述

属性

公共属性

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

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

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

FloatingPointAccuracy — 返回从 1.0 到下一个最大浮点数的距离 只读: 双精度

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` — 返回空的 `MWNumericArray` 的可写版本
只读: `MWNumericArray`

`FloatingPointAccuracy` — 返回从 1.0 到下一个最大浮点数的距离
只读: 双精度

`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` 中的元素数量
只读: 正整数