format

设置输出显示格式

语法

format(style)

fmt = format

fmt = format(style)

说明

format(style) 将输出显示格式更改为 style 指定的格式。例如，format("shortG") 以总共 5 位的紧凑形式显示数值。数值格式仅影响数字显示在的显示方式，而不是 MATLAB^® 计算或保存它们的方式。

当您按名称指定样式时，可以使用不带括号或引号的命令形式：

format shortG

示例

fmt = format 返回当前显示格式。（从 R2021a 开始）

示例

fmt = format(style) 将当前显示格式存储在 fmt 中，然后将显示格式更改为指定的样式。（从 R2021a 开始）

当请求输出时或传递变量作为输入时，无法使用命令形式。请将输入括在括号中，并将样式名称包含在引号中。

fmt = format("shortG");
format(fmt)

示例

全部折叠

长格式

打开实时脚本

将输出格式设置为长固定十进制小数点格式并显示 pi 的值。

format long
pi

ans = 
   3.141592653589793

十六进制格式

打开实时脚本

以十六进制格式显示整数和实数的最大值。

format hex
intmax('uint64')

ans = uint64
   ffffffffffffffff

realmax

ans = 
   7fefffffffffffff

短工程记数法和长工程记数法

打开实时脚本

显示 shortEng 和 longEng 格式之间的差异。

将输出格式设置为 shortEng。

format shortEng

创建变量，然后通过 for 循环每次将该变量的值增加 10 的倍数。

A = 5.123456789;
for k = 1:10
   disp(A)
   A = A*10;
end

     5.1235e+000

    51.2346e+000

   512.3457e+000

     5.1235e+003

    51.2346e+003

   512.3457e+003

     5.1235e+006

    51.2346e+006

   512.3457e+006

     5.1235e+009

这些值显示为在小数点后包含 4 位数，指数为 3 的倍数。

将输出格式设置为长工程格式并查看相同值。

format longEng

A = 5.123456789;
for k = 1:10
   disp(A)
   A = A*10;
end

    5.12345678900000e+000

    51.2345678900000e+000

    512.345678900000e+000

    5.12345678900000e+003

    51.2345678900000e+003

    512.345678900000e+003

    5.12345678900000e+006

    51.2345678900000e+006

    512.345678900000e+006

    5.12345678900000e+009

这些值显示为 15 位数，指数为 3 的倍数。

大数据范围格式

打开实时脚本

当数组中的一些值数字少，而指数大时，请使用 shortG 格式。shortG 格式在短固定十进制小数点格式和短科学记数法中选取最紧凑的显示格式。

创建一个变量并以默认的 short 格式显示输出。

x = [25 56.31156 255.52675 9876899999];
format short
x

x = 1×4
10⁹ ×

    0.0000    0.0000    0.0000    9.8769

将格式设置为 shortG 并重新显示这些值。

format shortG
x

x = 1×4

           25       56.312       255.53   9.8769e+09

将格式重置为默认值

将输出格式设置为紧凑行距的短工程格式。

format shortEng
format compact
x = rand(3)

x =
   814.7237e-003   913.3759e-003   278.4982e-003
   905.7919e-003   632.3592e-003   546.8815e-003
   126.9868e-003    97.5404e-003   957.5068e-003

将显示格式重置为默认值，并再次显示矩阵。

format default
x

x =

    0.8147    0.9134    0.2785
    0.9058    0.6324    0.5469
    0.1270    0.0975    0.9575

在 R2021a 之前，需要单独使用 format 将显示格式重置为默认值。

format

获取当前格式

打开实时脚本

自 R2021a 开始提供

获取当前显示格式。

fmt = format

fmt = 
  DisplayFormatOptions with properties:

    NumericFormat: "short"
      LineSpacing: "loose"

保存和还原显示格式

打开实时脚本

自 R2021a 开始提供

保存当前显示格式，并在以后还原。

将数值显示设置为 shortE，并显示 2×2 数值矩阵。

format shortE
m = [9638573934 37467; 236 574638295]

m = 2×2

   9.6386e+09   3.7467e+04
   2.3600e+02   5.7464e+08

以 oldFmt 格式保存当前显示格式，并将数值格式更改为 longE。

oldFmt = format("longE")

oldFmt = 
  DisplayFormatOptions with properties:

    NumericFormat: "shortE"
      LineSpacing: "loose"

通过重新显示矩阵 m，确认数值格式现在是长科学记数法。

m = 2×2

     9.638573934000000e+09     3.746700000000000e+04
     2.360000000000000e+02     5.746382950000000e+08

将格式还原到以前的状态。重新显示 m，以确认数值格式现在是短科学记数法。

format(oldFmt)
m

m = 2×2

   9.6386e+09   3.7467e+04
   2.3600e+02   5.7464e+08

输入参数

全部折叠

`style` — 要应用的格式
字符向量 | 字符串标量 | `DisplayFormatOptions` 对象

要应用的格式，指定为字符向量、字符串标量或 DisplayFormatOptions 对象。

字符向量或字符串标量必须为列出的样式名称之一或 default。

默认值

default 还原默认显示格式，数值格式为 short，行距为 loose。（从 R2021a 开始）

数值格式

这些样式可控制数值变量的输出显示格式。

`Style`	结果	示例
`short`	短固定十进制小数点格式，小数点后包含 4 位数。这是默认数值设置。	`3.1416`
`long`	长固定十进制小数点格式，`double` 值的小数点后包含 15 位数，`single` 值的小数点后包含 7 位数。	`3.141592653589793`
`shortE`	短科学记数法，小数点后包含 4 位数。	`3.1416e+00`
`longE`	长科学记数法，`double` 值的小数点后包含 15 位数，`single` 值的小数点后包含 7 位数。	`3.141592653589793e+00`
`shortG`	短固定十进制小数点格式或科学记数法（取更紧凑的一个），总共 5 位。	`3.1416`
`longG`	长固定十进制小数点格式或科学记数法（取更紧凑的一个），对于 `double` 值，总共 15 位；对于 `single` 值，总共 7 位。	`3.14159265358979`
`shortEng`	短工程记数法，小数点后包含 4 位数，指数为 3 的倍数。	`3.1416e+000`
`longEng`	长工程记数法，包含 15 位有效位数，指数为 3 的倍数。	`3.14159265358979e+000`
`+`	正/负格式，对正、负和零元素分别显示 `+`、`-` 和空白字符。	`+`
`bank`	货币格式，小数点后包含 2 位数。	`3.14`
`hex`	二进制双精度数字的十六进制表示形式。	`400921fb54442d18`
`rational`	小整数的比率。	`355/113`

行距格式

`Style`	结果	示例
`compact`	隐藏过多的空白行以便在一个屏幕上显示更多输出。	`theta = pi/2 theta = 1.5708`
`loose`	添加空白行以使输出更易于阅读。这是行距的默认设置。	`theta = pi/2 theta = 1.5708`

DisplayFormatOptions 对象有两个属性，即 NumericFormat 和 LineSpacing。字符向量和字符串标量输入的选项也是有效的属性值。有关使用 DisplayFormatOptions 对象的示例，请参阅保存和还原显示格式。

输出参量

全部折叠

`fmt` — 当前显示格式
`DisplayFormatOptions` 对象

当前显示格式，以具有以下属性的 DisplayFormatOptions 对象形式返回：

NumericFormat
LineSpacing

有关有效的属性值，请参阅 style 参量。

注意

属性值反映创建对象时显示格式的状态。当显示格式更改时，属性不会自动更改。有关示例，请参阅保存和还原显示格式。

提示

指定的格式仅应用于当前 MATLAB 会话。要在各会话之间保持格式，请在命令行窗口预设中选择数值格式或行距选项。
您可以单独指定 short 或 long 和表示形式类型，例如 format short E 或 format("short E")。
MATLAB 始终为整数数据类型显示适合该数据类型的恰当位数。例如，MATLAB 使用 3 位数显示 int8 数据类型（例如 -128:127）。将输出格式设置为 short 或 long 不会影响整数类型的变量的显示。
最多为 9 位数的整数值浮点数不以科学记数法显示。
如果要显示具有较宽范围的值的矩阵，请考虑使用 shortG。请参阅大数据范围格式。