formattedDisplayText

以字符串形式捕获显示输出

自 R2021a 起

全页折叠

语法

str = formattedDisplayText(X)

str = formattedDisplayText(X,Name,Value)

说明

示例

str = formattedDisplayText(X) 以字符串形式返回 X 的显示输出。该字符串包含 disp(X)。

示例

str = formattedDisplayText(X,Name,Value) 使用一个或多个 Name,Value 参数指定字符串的格式设置选项。

示例

全部折叠

以字符串形式捕获矩阵

打开实时脚本

创建一个 3×3 对角矩阵。

I = diag([1 1 1]);

使用 formattedDisplayText 以字符串形式捕获矩阵。

strI = formattedDisplayText(I)

strI = 
    "     1     0     0
          0     1     0
          0     0     1
     "

您也可以使用表达式作为输入。

strIplus = formattedDisplayText(2*I + ones(3))

strIplus = 
    "     3     1     1
          1     3     1
          1     1     3
     "

格式化逻辑值并以字符串形式捕获结构体

打开实时脚本

创建一个包含有关 UI 元素的信息的结构体。

S = struct('Type','Button','Size', 45,'Enabled',false)

S = struct with fields:
       Type: 'Button'
       Size: 45
    Enabled: 0

将 formattedDisplayText 与 UseTrueFalseforLogical 名称-值参数结合使用，以字符串形式捕获结构体且逻辑值显示为 true 或 false。

strS = formattedDisplayText(S,'UseTrueFalseForLogical',true)

strS = 
    "       Type: 'Button'
            Size: 45
         Enabled: false
     "

格式化表并以字符串形式捕获该表

创建一个表，其中包含客户姓名、帐户余额和最近几笔存款的金额。

Customer = ["Rivera";"Park";"Gupta"];
Balance = [5670;868.54;3015];
LastDeposit = [325.10;35.20;70];
T = table(Customer,Balance,LastDeposit)

T =

  3×3 table

    Customer    Balance    LastDeposit
    ________    _______    ___________

    "Rivera"      5670        325.1   
    "Park"      868.54         35.2   
    "Gupta"       3015           70

以字符串形式捕获该表。使用名称-值参数将数值格式化为银行样式，隐藏列标题的粗体标记，并删除具有紧凑行距的多余空行。

strT = formattedDisplayText(T,'NumericFormat','bank',...
'SuppressMarkup',true,'LineSpacing','compact')

strT = 

    "    Customer    Balance    LastDeposit
         ________    _______    ___________
         "Rivera"    5670.00      325.10   
         "Park"       868.54       35.20   
         "Gupta"     3015.00       70.00   
     "

输入参数

全部折叠

`X` — 以字符串形式返回的表达式
数组

输入数组。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： 'NumericFormat','shortE'

`NumericFormat` — 数值的格式
当前显示格式（默认） | `'short'` | `'long'` | `'shortE'` | `'longE'` | ...

数值的格式，指定为表中的格式之一：

样式	结果	示例
`'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`

`LineSpacing` — 行距的格式
当前显示格式（默认） | `'loose'` | `'compact'`

行距的格式，指定为 'loose' 或 'compact'：

样式	结果	示例
`'compact'`	隐藏过多的空白行以便在一个屏幕上显示更多输出。	`theta = pi/2 theta = 1.5708`
`'loose'`	添加空白行以使输出更易于阅读。	`theta = pi/2 theta = 1.5708`