第五十章 File 输入 输出

本页介绍在 IRIS 数据平台中使用顺序文件。

重要：在大多数情况下，可以使用 %Library.File 类提供的 API，而不需要此页面上的详细信息。请参阅使用 %Library.File 。

介绍

所有操作系统都将磁盘 I/O 文件视为顺序文件。 Windows 系统将打印机视为顺序文件 I/O 设备（除非打印机通过串行通信端口连接）。 UNIX® 系统将打印机视为终端 I/O` 设备。有关打印机的更多详细信息，请参阅打印机。

本节讨论 IRIS 如何处理顺序文件。它提供了顺序文件 I/O 的介绍以及相关命令的说明。

• 要访问顺序文件，必须首先使用OPEN命令打开该文件，并提供文件名作为参数。还可以选择指定OPEN模式参数。如果OPEN指定的文件不存在，则模式参数指定是否创建新文件。您可以同时打开多个文件。
• 打开顺序文件后，必须指定USE命令来访问该文件，并提供文件名作为参数。 USE命令使指定文件成为当前设备；因此一次只能使用一个文件。 USE命令还可以指定模式参数。
• 然后，可以对该文件发出多个READ或WRITE命令。每个READ或WRITE命令都会向文件传送一条记录或从文件传送一条记录。除非使用“W”模式参数打开该文件，否则无法写入该文件。尝试读取超过文件末尾会导致错误。
• 您可以使用$ZSEEK函数设置文件位置，该位置由从连续文件的开头、当前位置或结尾开始的字符计数偏移量指定。 $ZPOS特殊变量包含从当前顺序文件开头算起的当前字符计数位置。
• 完成文件 I/O 后，可以发出CLOSE命令来关闭顺序文件。

这些操作也可以使用 %Library.File 类的方法来执行。

%Library.File.Exists() 方法告诉您指定名称的连续文件是否已存在。

%Library.File.Size 属性返回顺序文件中当前的字符数。

打开文件时以及关闭文件时（如果已修改），%Library.File.DateModified 属性将更新为当前本地日期和时间。

如果文件已通过 %Library.File.Open() 方法打开，则 %Library.File.IsOpen 属性仅返回 1； OPEN命令不设置此布尔属性。

指定文件

顺序文件可以由规范（完整）路径名或系统扩展为完整路径名的相对（部分）路径名指定。路径名可以是规范的 (c:\InterSystems\IRIS\mgr\user\myfiles\testfile.txt) 或相对于当前目录 (testfile.txt)。前导句点 (.) 指定当前目录。前导双句点 (..) 指定当前目录的父目录。如果OPEN命令创建新文件，则指定的目录必须已经存在。

%SYSTEM.Process.OSError()方法返回操作系统返回的文件访问错误，例如The system Cannot find the file specified 。此方法返回用尖括号括起来的操作系统错误号，后跟错误文本。下面的 Windows 示例显示了这一点：

USER>OPEN "C:\InterSystems\IRIS\mgr\nodir\testfile.txt":("WNS"):5
 
USER>w $SYSTEM.Process.OSError()
<3> The system cannot find the path specified.

USER>w ##class(%File).TempFilename("txt","C:\InterSystems\IRIS\mgr\nodir\testfile",.oserrnum)

USER>w $SYSTEM.Process.OSError()
<3> The system cannot find the path specified.

以下 Windows 示例均在当前命名空间 (USER) 目录中创建文件：

• 完整路径名：OPEN "C:\InterSystems\IRIS\mgr\user\testfile1.txt":("WNS"):10
• 文件名扩展： OPEN "testfile2.txt":("WNS"):10
• 当前目录扩展: OPEN ".\testfile3.txt":("WNS"):10

以下 Windows 示例在当前命名空间 (USER) 目录的现有子目录中创建一个文件：

• 当前目录的子目录：OPEN "mytemp\testfile4.txt":("WNS"):10

以下 Windows示例使用父目录 (..) 语法创建文件：

• 父目录（ C:\InterSystems\IRIS\mgr\ ）： OPEN "..\testfile5.txt":("WNS"):10
• 当前目录（父目录的子目录） C:\InterSystems\IRIS\mgr\user\ ： OPEN "..\user\testfile6.txt":("WNS"):10 。
• 父目录C:\InterSystems\IRIS\mgr\temp\的另一个子目录： OPEN "..\temp\testfile7.txt":("WNS"):10 。
• 父目录C:\InterSystems\IRIS\的父目录： OPEN "..\..\testfile8.txt":("WNS"):10。

Windows 路径名使用 \（反斜杠）目录分隔符； UNIX 路径名使用 /（斜杠）目录分隔符。有效字符可以是 8 位 ASCII 或 ISO Latin-1 Unicode。

Windows 文件路径名规范具有以下格式：

device:\directory\file.type

例如， C:\InterSystems\IRIS\mgr\user\myfiles\testfile.txt 。类型后缀是可选的。

UNIX® 文件路径名规范具有以下格式：

../directory/name

完全展开时，文件路径名不得超过 256 个字符。如果所有目录的路径名长度超过 256，则会生成<DIRECTORY> 错误。如果由于文件名长度原因路径名长度超过 256，则会生成<NAMEADD> 错误。

UNIX® 文件路径名最多可以包含 255 个任何类型的字符。虽然字符句点（“.”）和下划线（“_”）可以出现在文件名中的任何位置，但您通常使用它们将名称划分为有意义的部分。例如，您可以定义文件名pat_rec.dat，使用.dat作为文件类型。

访问当前 UNIX® 默认目录中的文件时，通常只需指定名称。系统填写目录的默认值。

DLL 名称可以指定为完整路径名或部分路径名。如果指定部分路径名，IRIS 会将其扩展至当前目录。通常，DLL 存储在二进制目录（“bin”）中。要定位二进制目录，请调用 %SYSTEM.Util 类的 BinaryDirectory() 方法。