第五十一章 File 输入 输出 - 文件路径名工具
文件路径名工具
如果当前设备是顺序文件，则$ZIO包含该文件的完整路径名。
可以使用$ZSEARCH返回指定文件或目录的完整文件规范（路径名和文件名）。文件名可能包含通配符， $ZSEARCH使用通配符返回一系列满足通配符的完全限定路径名。
%Library.File 类包含许多提供文件系统服务的方法。这些包括：
-
NormalizeDirectory()，返回指定文件或目录的完整路径名。 -
NormalizeFilenameWithSpaces()，根据主机平台的情况处理路径名中的空格。如果路径名包含空格字符，则路径名处理取决于平台。Windows和UNIX®允许路径名中包含空格字符，但包含空格的整个路径名必须用一组附加的双引号(")字符括起来。这与Windows cmd/c语句一致。有关详细信息，请指定cmd / ?在Windows命令提示符下。
波形符 (~) 扩展
在 Windows 路径名中，波形符 (~) 表示长名称的 8.3 压缩。例如： c:\PROGRA~1\ 。要转换压缩目录名称，请使用 %Library.File 类的 NormalizeDirectory() 方法。
在 UNIX 路径名中，可以使用波形符 (~) 扩展来指示当前用户的主目录或指定用户的主目录：
-
~和~/myfile.txt分别扩展到当前用户的主目录：/Users/techwriter/和/Users/techwriter/myfile.txt。 -
~guest/myfile.txt扩展到用户“guest”的主目录：/Users/guest/myfile.txt。但是，如果用户“guest”不存在，IRIS会扩展为当前用户的完整目录路径名，并附加~guest/myfile.txt作为文字：/Users/techwriter/iris/mgr/user/~guest/myfile.txt。 -
~myfile.tx和~123.txt作为文字附加到当前用户的完整目录路径名：/Users/techwriter/iris/mgr/user/~myfile.txt和/Users/techwriter/iris/mgr/user/~分别为123.txt。
OPEN 命令
OPEN打开一个顺序文件。请记住，不能使用OPEN命令打开IRIS 数据库文件。
OPEN命令本身不会阻止另一个进程打开同一个顺序文件。可以使用OPEN命令“L”模式参数和/或 ObjectScript LOCK命令来管理并发顺序文件访问。文件锁定支持由底层操作系统的文件访问规则提供。
IRIS 在数据库文件和使用 ObjectScript OPEN命令打开的文件之间分配每个进程的打开文件配额。OPEN命令导致太多文件分配给OPEN命令时，发生错误。 IRIS 进程打开文件的最大数量为 1,024。每个进程的实际最大打开文件数是特定于平台的设置。例如，Windows 默认每个进程最多打开 998 个文件。请参阅适用于系统的操作系统文档。
OPEN语法
OPEN filename{{:({parameters{:reclength{:terminators}}})}{:timeout}}
filename
任何有效的文件规范，用引号引起来。该文件路径名不得超过 255 个字符。有效字符可以是 8 位 ASCII 或 ISO Latin-1 Unicode。在 UNIX 路径名中，您可以使用波形符 (~) 扩展来指示当前用户的主目录。例如： ~myfile或~/myfile。
parameters
可选- 一串单字母代码，用引号括起来，定义文件格式和您可以执行的操作类型。 （您还可以使用以斜杠 (/) 字符开头的关键字指定参数。）有关这些代码的定义，请参阅表OPEN 模式参数。如果参数不包含 R 或 W，则 R 为默认值。可以通过设置 Config.Miscellaneous 类的 OpenMode 属性来配置此系统范围的默认打开模式。要打开新文件，必须指定参数 N 表示新文件。否则， OPEN将挂起或因超时而无法成功返回。如果参数不包括 S、V、F 或 U，则新 Windows 或 UNIX 文件的默认模式为 S，现有文件的默认模式为创建文件时指定的模式。如果未指定 A，则WRITE操作将覆盖文件以前的内容。参数按从左到右的顺序应用。
- reclen
可选- 对于 Windows 和 UNIX 系统，指定 (S) 和 (U) 记录的最大记录长度，或指定固定长度 (F) 记录的绝对记录长度。忽略可变长度 (V) 记录。默认值为 32767。
- terminators
可选- 仅适用于流模式的用户定义的记录终止符字符串。它们允许您覆盖默认终止符：回车符、换行符和换页符。用户定义的终止符仅适用于输入，它们不会影响数据写入文件的方式（终止符作为特殊字符写入文件）。如果有多个用户定义的终止符，则会将其视为终止符列表，而不是用作单个终止符的多字符序列。
- timeout
可选— IRIS 尝试打开文件的秒数。如果在此时间间隔内未成功，则会将$TEST设置为 0 并将控制权返回给进程。如果成功，它将$TEST设置为 1。
超时参数虽然是可选的，但强烈建议使用，因为OPEN的成功或失败由$TEST特殊变量的值指示，并且仅在指定超时时才设置$TEST 。如果在超时到期之前打开尝试成功，则$TEST设置为 1；如果超时到期， $TEST将设置为 0。
