isfinite

确定哪些数组元素为有限

语法

TF = isfinite(A)

说明

TF = isfinite(A) 返回一个逻辑数组，其中的 1 (true) 对应数组 A 的有限元素，0 (false) 对应无限或 NaN 元素。如果 A 包含复数，则 isfinite(A) 中的 1 对应实部和虚部均为有限值的元素，0 对应实部或虚部中存在无限值或 NaN 值的元素。

示例

全部折叠

确定有限实数元素

打开实时脚本

创建一个行向量并确定有限实数元素。

A = 1./[-2 -1 0 1 2]

A = 1×5

   -0.5000   -1.0000       Inf    1.0000    0.5000

TF = isfinite(A)

TF = 1×5 logical array

   1   1   0   1   1

确定有限复数元素

打开实时脚本

创建一个复数数组。确定这些复数中是否包含有限值。

A = [2+1i 3+1i/0 0/0-2i]

A = 1×3 complex

   2.0000 + 1.0000i   3.0000 +    Infi      NaN - 2.0000i

TF = isfinite(A)

TF = 1×3 logical array

   1   0   0

A 的第二个元素具有无限虚部。第三个元素具有 NaN 实部。对于这两个元素，isfinite 返回 0。

输入参数

全部折叠

`A` — 输入数组
标量 | 向量 | 矩阵 | 多维数组

输入数组，指定为标量、向量、矩阵或多维数组。

提示

如果 x 是实数标量，则 isfinite(x)、isinf(x) 和 isnan(x) 中只有一个返回逻辑值 1 (true)。

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

isfinite 函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

isfinite 函数完全支持 GPU 数组。要在 GPU 上运行该函数，请将输入数据指定为 gpuArray (Parallel Computing Toolbox)。有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

另请参阅

allfinite | isinf | isnan

主题

使用 is* 函数检测状态

isfinite

语法

说明

示例

确定有限实数元素

确定有限复数元素

输入参数

A — 输入数组 标量 | 向量 | 矩阵 | 多维数组

提示

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

HDL 代码生成 使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。