num2str

将数字转换为字符数组

全页折叠

语法

s = num2str(A)
s = num2str(A,precision)
s = num2str(A,formatSpec)

说明

注意

对于数值标量和文本的组合，推荐使用 string 而不是 num2str。使用 + 运算符组合字符串和数值以提高可读性。有关其他信息，请参阅替代功能。

s = num2str(A) 将数值数组转换为表示数字的字符数组。输出格式取决于原始值的量级。num2str 对使用数值为绘图添加标签和标题非常有用。

示例

s = num2str(A,precision) 返回表示数字的字符数组，最大有效位数由 precision 指定。

示例

s = num2str(A,formatSpec) 将 formatSpec 指定的格式应用到 A 所有元素。

注意

如果指定了格式，s 将不会在 A 的元素之间包含空格。要包含空格，请在格式中添加一个空格。

示例

示例

全部折叠

打开实时脚本

将 pi 和 eps 返回的浮点值转换为字符向量。 

s = num2str(pi)
s = 
'3.1416'

s = num2str(eps)
s = 
'2.2204e-16'
打开实时脚本

指定浮点值的最大有效位数。 

rng('default')
A = randn([2,2]);
s = num2str(A,3)
s = 2×15 char array
    '0.538     -2.26'
    ' 1.83     0.862'
打开实时脚本

将 pi 显示为指定精度的浮点数。

formatSpec = '%.2f';
s = num2str(pi,formatSpec)
s = 
'3.14'

输入参数

全部折叠

输入数组，指定为数值数组。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical
复数支持: 是

输出字符串中的有效数字最大位数，指定为正整数。

注意

如果您指定的 precision 超出输入浮点数据类型的精度，则结果可能与您指定的精度的输入值不匹配。结果取决于您的计算机硬件和操作系统。

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

输出字段的格式，使用格式化操作符指定。formatSpec 还可以包括普通文本和特殊字符。

如果 formatSpec 包括表示转义字符的字面文本，如 \n，则 num2str 将转换转义字符。

formatSpec 可以是用单引号引起来的字符向量，也可以是字符串标量。

格式化操作符

格式化操作符以百分号 % 开头，以转换字符结尾。转换字符是必需的。您也可以在 % 和转换字符之间指定标识符、标志、字段宽度、精度和子类型操作符。（操作符之间的空格无效，在这里显示空格只是为了便于阅读。）

Schematic of formatting operator characters.

转换字符

此表显示了要将数值和字符数据格式化为文本的转换字符。

值类型转换详细信息

有符号整数

%d 或 %i

以 10 为基数

无符号整数

%u

以 10 为基数

%o

以 8 为基数（八进制）

%x

以 16 为基数（十六进制），小写字母 a–f

%X

与 %x 相同，大写字母 A–F

浮点数

%f

定点记数法（使用精度操作符指定小数点后的位数。）

%e

指数记数法，例如 3.141593e+00（使用精度操作符指定小数点后的位数）。

%E

与 %e 相同，但为大写，例如 3.141593E+00（使用精度操作符指定小数点后的位数）。

%g

更紧凑的 %e 或 %f，不带尾随零（使用精度操作符指定有效数字位数。）

%G

更紧凑的 %E 或 %f，不带尾随零（使用精度操作符指定有效数字位数。）

字符或字符串

%c

单个字符

%s

字符向量或字符串数组。输出文本的类型与 formatSpec 的类型相同。

可选运算符

可选标识符、标志、字段宽度、精度和子类型操作符进一步定义了输出文本的格式。

  • 标识符

    注意：与 sprintf 函数不同，num2str 不支持标识符。

  • 标志

    '–'

    左对齐。
    示例：%-5.2f
    示例：%-10s

    '+'

    始终为任何数值输出符号字符（+ 或 –）。
    示例：%+5.2f
    右对齐文本。
    示例：%+10s

    ' '

    在值之前插入空格。
    示例：% 5.2f

    '0'

    在值之前补零以填充字段宽度。
    例如：%05.2f

    '#'

    修改选定的数值转换：

    • 对于 %o、%x 或 %X，将输出 0、0x 或 0X 前缀。

    • 对于 %f、%e 或 %E，即使精度为零也将输出小数点。

    • 对于 %g 或 %G，不删除尾随零或小数点。

    示例：%#5.0f

  • 字段宽度

    要输出的最低字符数。

    示例：'%5d' 将 intmax 输出为 2147483647，因为 intmax 返回的值超出要输出的最小字符数。

    如果要输出的字符数小于字段宽度，则 compose 函数会使用空格填充值之前的字段宽度，除非标志另行指定。

    但是，num2str 函数不会用空格填充字段宽度。

  • 精度

    要打印的位数。

    对于 %f、%e 或 %E

    小数点右侧的位数
    示例：'%.4f' 将 pi 输出为 '3.1416'

    对于 %g 或 %G

    有效位数
    示例：'%.4g' 将 pi 输出为 '3.142'

    示例：'%6.4f' 将 pi 输出为 '3.1416'。

    注意

    如果您为浮点值指定的精度操作符所表示的精度超出输入数值数据类型的精度，则在指定精度内，结果与输入值可能不匹配。结果取决于您的计算机硬件和操作系统。

  • 子类型

    可以使用子类型操作符将浮点值显示为八进制、十进制或十六进制值。子类型操作符紧邻转换字符之前。此表显示了可使用子类型的转换。

    输入值类型

    子类型和转换字符

    输出值类型

    浮点数

    %bx 或 %bX
    %bo
    %bu

    双精度十六进制、八进制或十进制值
    例如：%bx 将 pi 输出为 400921fb54442d18

    %tx 或 %tX
    %to
    %tu

    单精度十六进制、八进制或十进制值
    例如：%tx 将 pi 输出为 40490fdb

格式化操作符前或后的文本

formatSpec 还可以在百分号 % 前添加其他文本，或者在转换字符后添加其他文本。文本可以为：

  • 要打印的普通文本。

  • 您无法作为普通文本输入的特殊字符。此表显示了如何在 formatSpec 中表示特殊字符。

    特殊字符

    表示形式

    单引号

    ''

    百分比字符

    %%

    反斜杠

    \\

    警报

    \a

    退格符

    \b

    换页符

    \f

    换行符

    \n

    回车符

    \r

    水平制表符

    \t

    垂直制表符

    \v

    其 Unicode® 数值可以通过十六进制数 N 表示的字符

    \xN

    示例：num2str('\x5A') 返回 'Z'

    其 Unicode 数值可以通过八进制数 N 表示的字符

    \N

    示例：num2str('\132') 返回 'Z'

使用格式化操作符进行转换时要注意的行为

  • 如果指定不适合数据的转换（例如数值的文本转换），MATLAB® 将改写指定的转换并使用 %e。

    示例：'%s' 将 pi 转换为 3.141593e+00。

  • 如果对整数值应用文本转换（%c 或 %s），MATLAB 会将对应于有效字符代码的值转换为字符。

    示例：'%s' 将 [65 66 67] 转换为 ABC。

输出参量

全部折叠

输入数组的文本表示形式，以字符数组的形式返回。

提示

  • num2str 不接受 formatSpec 输入参量中的位置标识符。例如，num2str([14 15],'%2$X %1$o) 将返回错误。

    位置标识符指定格式化操作符处理函数的输入参量的顺序，而不是处理输入数组的元素的顺序。当您调用 num2str 时，只有一个输入参量包含要转换的数字。

  • 如果您指定了无效的格式化操作符或特殊字符，则 num2str 会输出所有文本，直到出现无效的操作符或字符，并丢弃其余部分。

    示例：如果 formatSpec 是 'value = %z'，则 num2str 将输出 'value ='，因为 %z 不是格式化操作符。

    示例：如果 formatSpec 是 'character \x99999 = %s'，则 num2str 将输出 'character'，因为 \x99999 不是有效的特殊字符。

  • 建议在将数值转换为文本作为 eval 输入的一部分时使用 mat2str。

算法

num2str 将删除字符数组中的任何前导空格，即使 formatSpec 包含空格字符标志也是如此。例如，num2str(42.67,'% 10.2f') 返回一个 1×5 字符数组 '42.67'。

替代功能

更新使用 num2str 来组合数值标量与文本的代码，以改用 string。可以使用 + 运算符将数值与字符串组合在一起。例如：

不推荐推荐
newstr = ['The value is ' num2str(4.5)]
newstr =

    'The value is 4.5'
 
newstr = "The value is " + 4.5
newstr =

    "The value is 4.5"

扩展功能

全部展开

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | | | |