第五十七章 File 输入 输出 - READ 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

READ 命令从当前设备读取数据，一次读取一条记录。读取超过文件末尾会导致错误。

第五十五章 File 输入 输出 - 与非 InterSystems IRIS 软件的交互

与非 InterSystems IRIS 软件的交互

在 Windows 系统上，在 IRIS 中打开顺序文件以进行 “WL” 写入访问通常会阻止非 IRIS 应用程序打开顺序文件进行写入访问。同样，非 IRIS 应用程序打开顺序文件进行写入访问通常会阻止 IRIS 进程并发 “WL” 写入访问。

第五十三章 File 输入 输出 - OPEN模式参数

A /APPEND /APP

Append：WRITE 操作将数据附加到现有文件的末尾。默认设置是覆盖现有数据，而不是 append。

S /STREAM

流格式，回车符、换行符或换页符作为默认终止符。S、V、F 和 U 模式是互斥的。Stream record format 是默认格式。

V /VARIABLE

请勿尝试在可变长度顺序文件末尾以外的任何位置插入记录;WRITE 将使文件中的所有数据从 WRITE 之后的点开始无法访问。S、V、F 和 U 模式是互斥的。流记录 （S） 格式是默认格式。

使用转换表写入的可变长度记录（例如使用 UTF8 转换的 Unicode 数据）可能会导致存储的记录具有与输入数据不同的字符串长度。IRIS 在读取此记录时使用原始输入字符串长度。

第五十一章 File 输入 输出 - 文件路径名工具

文件路径名工具

如果当前设备是顺序文件，则$ZIO包含该文件的完整路径名。

可以使用$ZSEARCH返回指定文件或目录的完整文件规范（路径名和文件名）。文件名可能包含通配符， $ZSEARCH使用通配符返回一系列满足通配符的完全限定路径名。

%Library.File 类包含许多提供文件系统服务的方法。这些包括：

第四十九章 终端输入 输出 - 转义序列编程

转义序列编程

转义序列的 ANSI 标准使智能终端的编程变得实用。字符串中转义字符及其后面的所有字符不会显示在屏幕上，但会更新$X和$Y 。使用WRITE *语句将转义序列发送到终端，并通过直接设置$X和$Y来保持它们最新。

ANSI 标准建立了转义序列的标准语法。特定转义序列的效果取决于使用的终端类型。

每次READ之后在$ZB中查找传入的转义序列。 IRIS 将 ANSI 标准转义序列和任何其他使用 ANSI 形式的转义序列放入$ZB中。 IRIS 可识别两种形式的转义序列：

第四十六章 终端输入 输出 - CLOSE 命令

CLOSE 命令

释放设备的所有权，这是通过OPEN命令获得的。

语法

CLOSE device

终端预定义助记符空间

IRIS 提供了两个预定义的助记符空间供终端使用：

• ^%X364 用于 ANSI X3.64 终端
• ^%XDTM 用于 DTM PC 控制台

如果激活这些助记符空间之一，则可以在WRITE /mnemonic命令中使用与它们关联的控制助记符。还可以创建自己的助记符空间。有关助记符空间的更多信息，请参阅使用助记符空间控制设备。

以下部分描述了这些助记符空间的控制助记符。

第四十四章 终端输入 输出 - 特殊协议字符影响终端 I O

特殊协议字符影响终端 I O

每个操作系统都会拦截某些协议字符 (UNIX) 或组合键（例如 Windows 平台上的CTR-ALT-DEL ），以防止这些字符影响 IRIS。 Windows 控制台不会尝试覆盖这些操作系统特征。

其他特殊字符可以改变例程的执行方式，但不会出现在READ命令变量中。在图像模式下操作终端会取消这些效果，并使 IRIS 像对待任何其他字符一样对待这些字符。

READ受输出和输入控制字符的影响。 READ只是读取除终止字符之外的所有其他控制字符。它不回应他们。

输出控制字符影响例程的流程和输出。下表对此进行了描述：

第四十二章 终端输入 输出 - 显式终止符

显式终止符

OPEN或USE命令中的终止符参数允许您将特定字符定义为READ或WRITE命令的终止符。这些显式终止符可用于补充指定协议提供的终止符字符。终止符参数还可用于覆盖协议对字符的指定，并将其指定为终止符。将字符重新定义为终止符的能力的例外情况是：ASCII 0 (NULL)、ASCII 3 ( Ctrl-C ) 以及两个输出控制字符Ctrl-Q (XON) 和Ctrl-S (XOFF)。它们保留其功能，并且不能重新定义为终止符。

示例

此示例将 Z、 Backspace和Tab定义为主设备的终止符。下划线是连接运算符。

第四十章 终端输入 输出 - 用于OPEN和USE的字母代码协议

用于OPEN和USE的字母代码协议

特殊情况或终端可能需要不同的协议。使用协议字母代码参数（或相应的关键字参数），可以更改 IRIS 与终端通信的规则。协议对正常读取和单字符读取的影响是一样的。

禁用所有特殊协议的正常模式足以满足大多数终端 I/O 的需要。在正常模式下，IRIS 会回显每个传入的 ASCII 字符，并将其发送回以显示在终端上。 Return或有效的转义序列结束READ命令。

对终端发出OPEN会关闭所有先前的协议，除非您使用 + 和 - 选项。

下表描述了有效的协议字符及其效果。

第三十九章 终端输入 输出 - terminator

terminator

第三个位置参数：最多八个字符的字符串，其中任何一个都将终止READ 。这些终止符是协议中内置终止符的补充。请参阅使用终止符结束 I/O 操作。

portstate

第 4 个位置参数：按位置顺序最多包含 8 个字节的字符串，用于控制 COM 端口状态。端口状态字节如下（字节从1开始按从左到右的顺序编号）：

第三十七章 终端输入 输出 - $ZB 显示结束读取的内容

$ZB 显示结束读取的内容

$ZB显示当前设备上最后一次READ操作结束的字符序列或事件。不能设置$ZB ；每次执行READ时，IRIS 都会设置$ZB的值。可以使用此值来作用于不可打印的字符，例如向上箭头键或功能键。

$ZB可以包含以下任意内容：
- 终止符，例如回车符
- 转义序列
- 固定长度READ x#y的字符数y
- READ *x的单个字符
- 定时读取过期后出现空字符串

$ZB永远不会包含超过 64 个字符。较长的转义序列无效。

第三十五章 终端输入 输出 - 特殊变量显示 I O 条件

WRITE * and $X and $Y

WRITE *不会更改$X和$Y。因此，可以将控制序列发送到终端， $X和$Y仍将反映真实的光标位置。某些控制序列确实会移动光标，因此可以在需要时直接设置$X或$Y 。

$X 和 $Y 示例

在以下示例中，控制序列将 VT100 终端中的光标移动到第 10 行、第 20 列，并相应地设置$X和$Y 。

第三十三章 UDP 客户端 服务器通信 - IPv4 和 IPv6

UDP 支持 IPv4 和 IPv6 互联网协议。由于这些协议不兼容，服务器和客户端都必须使用相同的Internet协议，否则传输将失败。

IPv4 地址具有以下格式。 n是 0 到 255 范围内的十进制整数：

n.n.n.n

可以将 IPv4 协议指定为"0.0.0.0" 。

IPv6 地址具有以下完整格式。 h是一个具有四个十六进制数字的十六进制数：

第三十一章 TCP 高级主题

本页讨论使用 TCP/IP 在 IRIS 数据平台进程之间进行通信的几个高级主题。

连接管理

服务器一次仅维护一个连接。如果在另一个连接打开时第二个客户端尝试连接，TCP/IP 会将该客户端放入队列中。在队列中时，第二个客户端可以向端口写入数据，就像已连接一样。第二个客户端写入的数据保留在缓冲区中，直到第一个连接关闭并且第二个客户端连接为止。

如果第二个客户端在连接存在之前发出READ，则会挂起。当第二个客户端在队列中时，第三个客户端的任何连接尝试都会失败。

如果已经打开 TCP 设备的客户端在第一个连接仍然存在时尝试第二次连接，则第二个OPEN命令会导致错误。将这种情况视为错误而不是USE命令可以防止出现意外的结果。如果错误的程序认为它已打开新连接，而实际上它正在重用可能具有不同目标或不同参数的现有连接，则可能会出现此类意外结果。