Main Content

ferror

文件 I/O 错误信息

全页折叠

语法

message = ferror(fileID)
[message,errnum] = ferror(fileID)
[message,errnum] = ferror(fileID,'clear')

说明

示例

message = ferror(fileID) 为指定文件最近的文件 I/O 操作返回错误消息。

[message,errnum] = ferror(fileID) 返回与错误消息关联的错误编号。

[message,errnum] = ferror(fileID,'clear') 清除指定文件的错误指示符。可以字符向量或字符串标量形式指定字面 clear。如果清除错误指示符，随后调用 ferror 的效果就如同最近的 I/O 操作成功一样。

示例

全部折叠

打开实时脚本

返回有关您指定的文件中最近出现的文件 I/O 错误的详细信息。

打开要读取的文件。 

fid = fopen('outages.csv','r');

将读取位置设置为从文件开始处算起的 -5 个字节。由于在文件开始之前没有数据存在，因此 fseek 返回 -1 ，表示操作失败。 

status = fseek(fid,-5,'bof')
status = -1

使用文件标识符 fid 获取文件中最近出现的错误消息的详细信息。

error = ferror(fid) 
error = 
'Offset is bad - before beginning-of-file.'

关闭文件。

fclose(fid);

输入参数

全部折叠

已打开文件的文件标识符，指定为整数。fileID 可以是下列值之一：

  • N - 从具有有效文件标识符（由 fopen 函数生成）的文件进行输入或输出。N 等于或大于 3。

  • 0 - 从标准输入设备进行输入。

  • 1 - 输出到标准输出设备。

  • 2 - 标准错误。

数据类型： double

输出参数

全部折叠

错误消息，以字符向量形式返回，其中包含与最近的 I/O 操作关联的错误消息。如果最近的 I/O 操作成功或者您手动清除了错误消息，则 message 为空字符向量。

错误编号，返回与最近的文件 I/O 操作的错误关联的整数代码。如果最近的文件 I/O 操作成功，则 errnum 为 0。非零 errnum 指示发生错误：

  • 负值对应于 MATLAB® 错误消息。

  • 正值对应于系统的 C 库错误消息。

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | | | | | |