文章
· 十二月 14, 2024 阅读大约需 4 分钟

第五十章 File 输入 输出

第五十章 File 输入 输出

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

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

介绍

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

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

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

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

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

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

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

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

指定文件

顺序文件可以由规范(完整)路径名或系统扩展为完整路径名的相对(部分)路径名指定。路径名可以是规范的 (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 路径名使用 /(斜杠)目录分隔符。有效字符可以是 8ASCIIISO 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() 方法。

讨论 (0)1
登录或注册以继续