sfi

（不推荐）构造有符号定点数值对象

全页折叠

不推荐使用 sfi。请改用 fi。

语法

a = sfi

a = sfi(v)

a = sfi(v,w)

a = sfi(v,w,f)

a = sfi(v,w,slope,bias)

a = sfi(v,w,slopeadjustmentfactor,fixedexponent,bias)

说明

a = sfi 是默认构造函数，返回不带值的有符号 fi 对象，其字长为 16 位，小数长度为 15 位。

由 sfi 构造函数创建的 fi 对象具有数据属性、fimath 属性和 numerictype 属性。这些属性在 fi 属性、fimath 属性和 numerictype 属性中进行了详细介绍。

由 sfi 构造函数创建的 fi 对象没有局部 fimath 对象。如果不想使用默认 fimath 设置，则可以将 fimath 对象关联到该 fi 对象。有关详细信息，请参阅fimath Object Construction。

示例

a = sfi(v) 返回一个有符号定点对象，其值为 v，字长为 16 位，具有最佳精度小数长度。最佳精度是在小数长度自动设置为适应给定字长的值 v 时提供的。

示例

a = sfi(v,w) 返回一个有符号定点对象，其值为 v，字长为 w，具有最佳精度小数长度。

示例

a = sfi(v,w,f) 返回一个有符号定点对象，其值为 v，字长为 w，小数长度为 f。

示例

a = sfi(v,w,slope,bias) 返回一个有符号定点对象，其值为 v，字长为 w，斜率为 slope 且偏置为 bias。

a = sfi(v,w,slopeadjustmentfactor,fixedexponent,bias) 返回一个有符号定点对象，其值为 v，字长为 w，斜率调整因子为 slopeadjustmentfactor，固定指数为 fixedexponent，偏置为 bias。

示例

全部折叠

创建具有默认值的有符号 `fi` 对象

默认构造函数返回不带值的有符号 fi 对象，其字长为 16 位，小数长度为 15 位。

a = sfi

a = 

[]

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 15

创建具有默认字长和最佳精度小数长度的有符号 `fi` 对象

创建一个有符号 fi 对象，其默认字长为 16 位，具有最佳精度小数长度。

a = sfi(pi)

a =
 
    3.1416

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 13

创建一个具有最佳精度小数长度的有符号 `fi` 对象

如果省略参量 f，则小数长度会自动设置为可能的最佳精度。

a = sfi(pi,8)

a =
 
    3.1563

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 5

创建具有指定字长和小数长度的有符号 `fi` 对象

创建一个有符号 fi 对象，其值为 pi，字长为 8 位，小数长度为 3 位。

a = sfi(pi,8,3)

a =
 
    3.1250

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 3

默认 fimath 属性与 a 相关联。当 fi 对象没有局部 fimath 对象时，其输出中不会显示任何 fimath 对象属性。要确定 fi 对象是否有局部 fimath 对象，请使用 isfimathlocal 函数。

isfimathlocal(a)

ans =
     0

返回值 0 意味着 fi 对象没有局部 fimath 对象。当 isfimathlocal 函数返回 1 时，fi 对象有局部 fimath 对象。

值 v 也可以是数组。

a = sfi((magic(3)/10),16,12)

a = 

    0.8000    0.1001    0.6001
    0.3000    0.5000    0.7000
    0.3999    0.8999    0.2000

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 12

输入参数

全部折叠

`v` — 值
标量 | 向量 | 矩阵 | 多维数组

有符号 fi 对象的值，指定为标量、向量、矩阵或多维数组。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi

`w` — 字长
16 (默认) | 整数标量

有符号 fi 对象的字长，以位为单位，指定为整数标量。

`f` — 小数长度
15 (默认) | 整数标量

有符号 fi 对象的小数长度，以位为单位，指定为整数标量。如果不指定小数长度，则对于指定的值和字长，有符号 fi 对象会在避免出现溢出的情况下自动使用可提供最佳精度的小数长度。

`slope` — 斜率
整数标量

定标的斜率，指定为整数标量。以下方程表示斜率偏置定标数的真实值。

$r e a l - w o r l d v a l u e = (s l o p e \times i n t e g e r) + b i a s$

`bias` — 偏置
标量

定标的偏置，指定为标量。以下方程表示斜率偏置定标数的真实值。

$r e a l - w o r l d v a l u e = (s l o p e \times i n t e g e r) + b i a s$

`slopeadjustmentfactor` — 斜率调整因子
整数标量

斜率偏置定标数的斜率调整因子。以下方程说明斜率、固定指数和斜率调整因子之间的关系。

$s l o p e = s l o p e a d j u s t m e n t f a c t o r \times 2^{f i x e d e x p o n e n t}$

`fixedexponent` — 固定指数
整数标量

斜率偏置定标数的固定指数。以下方程说明斜率、固定指数和斜率调整因子之间的关系。

$s l o p e = s l o p e a d j u s t m e n t f a c t o r \times 2^{f i x e d e x p o n e n t}$

扩展功能

全部展开

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

使用说明和限制：

对于代码生成，所有与数据类型相关的属性都必须为常量。

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

版本历史记录

在 R2009b 中推出

另请参阅

sfi

语法

说明

示例

创建具有默认值的有符号 fi 对象

创建具有默认字长和最佳精度小数长度的有符号 fi 对象

创建一个具有最佳精度小数长度的有符号 fi 对象

创建具有指定字长和小数长度的有符号 fi 对象

输入参数

v — 值 标量 | 向量 | 矩阵 | 多维数组

w — 字长 16 (默认) | 整数标量

f — 小数长度 15 (默认) | 整数标量

slope — 斜率 整数标量

bias — 偏置 标量

slopeadjustmentfactor — 斜率调整因子 整数标量

fixedexponent — 固定指数 整数标量