转换字符

转换字符指定输出的表示法。它包含单个字符并显示在格式设定符的最后。

例如，使用不同的转换字符来格式化数值 46，以十进制、定点、指数和十六进制格式显示该数值。

A = 46*ones(1,4);
txt = sprintf('%d   %f   %e   %X', A)

txt = 
'46   46.000000   4.600000e+01   2E'

子类型

子类型字段为单个字母字符，该字符紧挨在转换字符之前。如果没有子类型字段，转换字符 %o、%x、%X 和 %u 会将输入数据按整数进行处理。要将输入数据按浮点值进行处理并将它们转换为八进制、十进制或十六进制表示形式，请使用以下子类型设定符之一。

精度

格式化操作符中的精度字段是一个非负整数，紧跟在句点之后。例如，在操作符 %7.3f 中，精度为 3。对于 %g 操作符，精度指示要显示的有效位数。对于 %f、%e 和 %E 操作符，精度指示要显示在小数点右侧的位数。

使用精度字段按不同精度显示数值。

txt = sprintf('%g   %.2g   %f   %.2f', pi*50*ones(1,4))

txt =

    '157.08   1.6e+02   157.079633   157.08'

虽然您可以在格式化操作符中为输入文本指定精度（例如，在 %s 操作符中），但通常不会这么做。如果您将精度指定为 p，并且 p 小于输入文本中的字符数，则输出将仅包含前 p 个字符。

字段宽度

格式化操作符中的字段宽度是一个非负整数，用于在格式化输入值时指定输出中的位数或字符数。例如，在操作符 %7.3f 中，字段宽度为 7。

指定不同的字段宽度。要显示每个输出的宽度，请使用 | 字符。默认情况下，当字段宽度大于字符数时，输出文本会使用空格字符进行填充。

txt = sprintf('|%e|%15e|%f|%15f|', pi*50*ones(1,4))

txt =

    '|1.570796e+02|   1.570796e+02|157.079633|     157.079633|'

用在文本输入时，字段宽度可确定是否要使用空格填充输出文本。如果字段宽度小于或等于输入文本中的字符数，则没有任何影响。

txt = sprintf('%30s', 'Pad left with spaces')

txt =

    '          Pad left with spaces'

标志

标志是可选项，用于控制输出文本的其他格式。下表介绍了可用作标志的字符。

左对齐或右对齐输出。默认行为是右对齐输出文本。

txt = sprintf('right-justify: %12.2f\nleft-justify: %-12.2f',...
              12.3, 12.3)

txt =

    'right-justify:        12.30
     left-justify: 12.30       '

显示正数的 + 符号。对于正数，默认行为是忽略前导的 + 符号。

txt = sprintf('no sign: %12.2f\nsign: %+12.2f',...
              12.3, 12.3)

txt =

    'no sign:        12.30
     sign:       +12.30'

用空格或零向左侧填充。默认行为是使用空格进行填充。

txt = sprintf('Pad with spaces: %12.2f\nPad with zeroes: %012.2f',...
              5.2, 5.2)

txt =

    'Pad with spaces:         5.20
     Pad with zeroes: 000000005.20'

值标识符

默认情况下，sprintf 等函数会按顺序将值从输入参量插入到输出文本中。要按非顺序处理输入参量，请通过在格式设定符中使用数值标识符来指定顺序。指定非连续的参量时，需要在 % 符号后紧接一个整数，并在整数后面添加 $ 符号。

sprintf('%s %s %s',...
        '1st','2nd','3rd')

ans =

    '1st 2nd 3rd'

sprintf('%3$s %2$s %1$s',...
        '1st','2nd','3rd')

ans =

    '3rd 2nd 1st'

特殊字符

特殊字符可以是输出文本的一部分。但是，由于它们不能以普通文本形式输入，因此需要使用特定的字符序列来表示。要将特殊字符插入到输出文本中，请使用下表中的任何字符序列。

精度和字段宽度的格式化规则

下图演示了字段宽度和精度设置如何影响格式化函数的输出。在该图中，格式化操作符中 % 符号后面的零表示为输出文本添加前导零，而非空格字符。

在格式设定符外部指定字段宽度和精度

您可以使用顺序参量列表中的值来指定字段宽度和精度。使用星号 (*) 来代替格式化操作符的字段宽度或精度字段。

例如，格式化并显示三个数值。在每种情况中，都使用星号以指定字段宽度或精度取自跟在格式设定符后面的输入参量。

txt = sprintf('%*f   %.*f   %*.*f',...
              15,123.45678,...     
              3,16.42837,...       
              6,4,pi)

txt =

    '     123.456780   16.428   3.1416'

下表介绍了该示例中每个格式化操作符的作用。

您可以混合使用两种形式。例如，从后跟的输入参量获取字段宽度，从格式设定符获取精度。

txt = sprintf('%*.2f', 5, 123.45678)

txt =

    '123.46'

在宽度和精度字段中指定带编号的标识符

您也可以使用下图中所示的语法将字段宽度和精度指定为非顺序的参量列表中的值。在格式化操作符中，使用跟在编号标识符和 $ 符号后面的星号指定字段宽度和精度。使用跟在格式设定符后面的输入参量指定字段宽度和精度的值。

例如，格式化并显示三个数值。在每种情况中，都使用编号标识符以指定字段宽度或精度取自跟在格式设定符后面的输入参量。

txt = sprintf('%1$*4$f   %2$.*5$f   %3$*6$.*7$f',...
              123.45678, 16.42837, pi, 15, 3, 6, 4)

txt =

    '     123.456780   16.428   3.1416'

下表介绍了该示例中每个格式化操作符的作用。