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   
     "

输入参数

全部折叠

输入数组。

名称-值参数

全部折叠

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

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

示例: 'NumericFormat','shortE'

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

样式

结果

示例

'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

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

样式

结果

示例

'compact'

隐藏过多的空白行以便在一个屏幕上显示更多输出。

theta = pi/2
theta =
1.5708

'loose'

添加空白行以使输出更易于阅读。

theta = pi/2

theta =

1.5708

显示标记的状态，指定为 false 或 true。当该参量设置为 false 时，输出会像在命令行窗口中一样显示，例如，包括文档超链接和表头的粗体格式。当参量设置为 true 时，输出不显示标记，如超链接和粗体。

逻辑值显示预设项，指定为 false 或 true。当参量设置为 false 时，逻辑值显示为 1 和 0。当参量设置为 true 时，逻辑值显示为字样“true”和“false”。

版本历史记录

在 R2021a 中推出

另请参阅

|