Main Content

sfi

(不推荐)构造有符号定点数值对象

不推荐使用 sfi。请改用 fi

说明

示例

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

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

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 对象,其字长为 16 位,小数长度为 15 位。

a = sfi
a = 

[]

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

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

a = sfi(pi)
a =
 
    3.1416

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

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

a = sfi(pi,8)
a =
 
    3.1563

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

创建一个有符号 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

输入参数

全部折叠

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

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

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

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

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

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

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

real-world value=(slope×integer)+bias

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

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

real-world value=(slope×integer)+bias

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

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

slope=slope adjustment factor×2fixed exponent

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

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

slope=slope adjustment factor×2fixed exponent

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

扩展功能

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

版本历史记录

在 R2009b 中推出