从文件读取

使用此工具从文件读取文本。

输入应在参数文件名称中读取的文件的路径。通过将 “连接” 参数设为 1，打开要读取的文件。使用执行 MERLIC 一次的按钮 ，以单步执行此工具。此功能允许您逐步读取文本。通过将参数 “连接” 设置为 0 并执行 MERLIC 一次 来关闭文件。文件由 MVApp 打开时，可以被其他流程访问。

参数

基本参数

文件名称：

此参数定义了从中读取文本的文件名称。默认情况下设置为“Me_log.txt”，保存在“%USERPROFILE%\Documents”目录中。您可以在相应的连接器中更改或选择所需的文件名称和路径。如果定义了相对文件路径，则会在相对于默认目录“%USERPROFILE%\Documents”的路径中搜索该文件。但是，如果在定义相对文件路径时已保存 MVApp，则会在相对于 MVApp 所在目录的路径搜索该文件。

连接：

此参数定义与文件的连接是激活还是停用。默认情况下，此参数设置为 0。这表示与文件的连接未激活，因此未打开文件进行读取。如果要开始读取选定的文件，您需要设置参数为“1”才能打开文件。

由于每次更改值都会执行工具，所以我们建议将“连接”参数设置为 0，直至该工具已完全配置。

读取模式：

此参数定义了读取模式。默认情况下设置为“字”。您可以在相应的连接器中更改“读取模式”。

值	描述
字符	逐个字符读取文本。
字	逐个字读取文本。
线	逐行读取文本。

按周期读取访问：

此参数定义了执行 MERLIC Vision App一次所允许的读取访问数量。默认情况下，此参数设置为 1。这表示，如果“读取模式”设置为“字”，则每个周期只读取 1 个字。

其他参数

文件句柄：

此参数可用于指定从前一工具（“文件句柄”已定义）读取的文件的句柄。如果此参数已设置，则参数 “文件名称” 将被忽略，并使用定义了 “文件句柄” 的文件。

结果

基本结果

文本：

此结果包含从文件读取的字符串形式的文本。

已到文件末尾：

此结果提供是否到达文件末尾的信息。返回结果为布尔值。如果其值为 1，则表示已到达文件末尾。

当前文件名称：

此结果包含上次迭代中读取的文件的名称和绝对文件路径，例如“C:\Users\Public\Documents\MVTec\MERLIC\Me_log.txt”。

工具状态：

“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。

其他结果

使用的文件句柄：

此结果代表从中读取文本的文件的句柄。它可被以下工具用于写入或读取。应避免几个工具使用相同的句柄同时读取同一文件或写入同一文件，否则可能会导致意外效果。

处理时间:

此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。