目录

说明

示例

输出字面文本和数组值

将双精度值输出为整数

将表格数据写入文本文件

获取写入文件的字节数

在命令行窗口中显示超链接

fprintf函数的功能是将数据写入文本文件。

fprintf(fileID,formatSpec,A1,...,An)

fprintf(formatSpec,A1,...,An)

nbytes = fprintf(___)

说明

fprintf(fileID,formatSpec,A1,...,An) 按列顺序将 formatSpec 应用于数组 A1,...An 的所有元素，并将数据写入到一个文本文件。fprintf 使用在对 fopen 的调用中指定的编码方案。

fprintf(formatSpec,A1,...,An)设置数据的格式并在屏幕上显示结果。

nbytes = fprintf(___)使用前述语法中的任意输入参数返回fprintf所写入的字节数。

示例

输出字面文本和数组值

        将多个数值和字面文本输出到屏幕。

A1 = [9.9, 9900];
A2 = [8.8,  7.7 ; ...
      8800, 7700];
formatSpec = 'X is %4.2f meters or %8.3f mm\n';
fprintf(formatSpec,A1,A2)
X is 9.90 meters or 9900.000 mm
X is 8.80 meters or 8800.000 mm
X is 7.70 meters or 7700.000 mm

        formatSpec 输入中的 %4.2f 指定输出中每行的第一个值为浮点数，字段宽度为四位数，包括小数点后的两位数。formatSpec 输入中的 %8.3f 指定输出中每行的第二个值为浮点数，字段宽度为八位数，包括小数点后的三位数。\n 为新起一行的控制字符。

将双精度值输出为整数

        显式将包含分式的双精度值转换为整数值。

a = [1.02 3.04 5.06];
fprintf('%d\n',round(a));
1
3
5

        formatSpec 输入中的 %d 将向量 round(a) 中的每个值作为有符号整数输出。\n 为新起一行的控制字符。

将表格数据写入文本文件

        将指数函数的短表写入到名为 exp.txt 的文本文件。

x = 0:.1:1;
A = [x; exp(x)];

fileID = fopen('exp.txt','w');
fprintf(fileID,'%6s %12s\n','x','exp(x)');
fprintf(fileID,'%6.2f %12.8f\n',A);
fclose(fileID);

        第一个对 fprintf 的调用输出标题文本 x 和 exp(x)，第二个调用输出变量 A 的值。

        如果打算使用 Microsoft® 记事本读取文件，请使用 '\r\n' 而不是 '\n' 移到新行。例如，将对 fprintf 的调用替换为下列项：

fprintf(fileID,'%6s %12s\r\n','x','exp(x)');
fprintf(fileID,'%6.2f %12.8f\r\n',A);

        MATLAB® 导入函数、所有 UNIX® 应用程序以及 Microsoft Word 和写字板都将 '\n' 识别为换行指示符。

        通过 type 命令查看文件的内容。

type exp.txt
     x       exp(x)
  0.00   1.00000000
  0.10   1.10517092
  0.20   1.22140276
  0.30   1.34985881
  0.40   1.49182470
  0.50   1.64872127
  0.60   1.82211880
  0.70   2.01375271
  0.80   2.22554093
  0.90   2.45960311
  1.00   2.71828183

获取写入文件的字节数

        将数据写入文件并返回所写入的字节数。将数据数组 A 写入文件并获取 fprintf 所写入的字节数。

A = magic(4);

fileID = fopen('myfile.txt','w');
nbytes = fprintf(fileID,'%5d %5d %5d %5d\n',A)
nbytes = 96

        fprintf 函数向文件中写入了 96 个字节。关闭文件。

fclose(fileID);

        通过 type 命令查看文件的内容。

type('myfile.txt')
   16     5     9     4
    2    11     7    14
    3    10     6    15
   13     8    12     1

在命令行窗口中显示超链接

        在屏幕上显示超链接（MathWorks公式网站）。

url = 'https://www.mathworks.com';
sitename = 'The MathWorks Web Site';

fprintf('<a href = "%s">%s</a>\n',url,sitename)

        formatSpec输入中的%s指示变量url和sitename的值应作为文本输出。

        文件标识符，指定为下列值之一：

• 从fopen获取的文件标识符。

• 1 表示标准输出（屏幕）。

• 2 表示标准错误。

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

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

格式化操作符

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

转换字符

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

可选操作符

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

标识符

        处理函数输入参数的顺序。使用语法 n$，其中n代表函数调用中其他输入参数的位置。

        注意：如果输入参数为数组，则不能使用标识符指定该输入参数中的特定数组元素。

标志

字段宽度

        要输出的最低字符数。字段宽度操作符可以是数字，也可以是指向输入参数的星号 (*)。

        当将*指定为字段宽度操作符时，其他输入参数必须指定打印宽度和要打印的值。宽度和值可以是参数对组，也可以是数值数组中的对组。使用*作为字段宽度操作符时，可以打印具有不同宽度的不同值。

        除非标志另行指定，否则该函数使用空格填充值之前的字段宽度。

精度

        精度操作符可以是数字，也可以是指向参数的星号 (*)。

        当将 * 指定为字段精度操作符时，其他输入参数必须指定打印精度和要打印的值。精度和值可以是参数对组，也可以是数值数组中的对组。使用 * 作为精度操作符时，可以打印具有不同精度的不同值。

        将*.*指定为字段宽度和精度操作符时，必须以三元组形式指定字段宽度、精度和值。

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

子类型

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

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

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

• 要打印的普通文本。

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

  特殊字符	表示形式
  单引号	''
  百分比字符	%%
  反斜杠	\\
  警报	\a
  退格符	\b
  换页符	\f
  换行符	\n
  回车符	\r
  水平制表符	\t
  垂直制表符	\v
  其 Unicode® 数值可以通过十六进制数 N 表示的字符	\xN 示例：sprintf('\x5A') 返回 'Z'
  其 Unicode 数值可以通过八进制数 N 表示的字符	\N 示例：sprintf('\132') 返回 'Z'

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

• 数值转换仅输出复数的实部。

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

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

提示

• 读取函数 sscanf 和 fscanf 的格式设定符不同于写入函数sprintf 和 fprintf 的格式。读取函数不支持精度字段。宽度字段在写入函数中指定最小值，但在读取函数中指定最大值。