single

单精度数组

说明

MATLAB^® 中的单精度变量存储为 single 数据类型（类）的 4 个字节（32 位）浮点值。例如：

y = single(10);
whos y

Name      Size            Bytes  Class     Attributes

  y         1x1                 4  single

有关浮点值的详细信息，请参阅浮点数。

创建对象

如果您有一个数组由不同的数据类型（如 double 或 int8）组成，则可以使用 single 函数将该数组转换为单精度数组。

语法

Y = single(X)

描述

Y = single(X) 将 X 中的值转换为单精度。

示例

输入参量

全部展开

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

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

示例

全部折叠

转换为单精度变量

打开实时脚本

使用 single 函数将双精度变量转换为单精度。

x = 100;
xtype = class(x)

xtype = 
'double'

y = single(x)

y = single

100

扩展功能

全部展开

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

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

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

用法说明和限制：

将单精度整数与colon运算符结合使用时，如果任一端点的绝对值大于 MATLAB 代码中的 flintmax('single')，则生成代码可能会产生与 MATLAB 代码不同的值。例如：
```
function z = mismatch_values
a = single(1);
b = flintmax('single') + 2;
d = single(9);
z = a:d:b;
end
```
由于生成代码和 MATLAB 代码使用的舍入方法不同，由生成代码和 MATLAB 代码计算的 z 值也不同。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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

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

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

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

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

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

版本历史记录

在 R2006a 之前推出

另请参阅

double | cast | typecast

single

说明

创建对象

语法

描述

输入参量

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

示例

转换为单精度变量

扩展功能

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

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

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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

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

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