写入文件

使用此工具将文本写入文件。

在参数“文件名称”中输入路径和文件名。如果连接器“连接”设置为 1 并且执行“MVApp”，则“MVApp”将创建并打开文件。只要文件由 MVApp 打开，就不能被其他流程使用。如果“连接”设置为 1，则 MVApp 每次执行时都会应用写入操作。使用执行 MERLIC 一次的按钮，以单步执行此工具。此功能允许您逐步写入文本。将连接器“连接”设为 0 可以关闭文件。

执行行为

此工具的执行行为不同于默认行为。通常，在以下情况下会执行 MERLIC 工具：

MERLIC Vision App 在连续模式下显式执行。
MERLIC Vision App 在“运行一次”模式下显式执行。
在 MERLIC Creator 中打开了包含该工具的 MERLIC Vision App。
在 MERLIC Creator 中更改了该工具的参数值。

不过，仅在以下情况下会执行工具 “写入文件”：

MERLIC Vision App 在连续模式下显式执行。
MERLIC Vision App 在“运行一次”模式下显式执行。

这可以确保在加载 MVApp 或更改该工具的参数值时不应用写入操作。

参数

基本参数

文件名称：

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

连接：

此参数定义与文件的连接是激活还是停用。默认情况下，此参数设置为 0。这表示与文件的连接未激活，因此未创建文件或未打开文件进行写入。要开始向文件写入数据，您需要将参数设为 1 并通过“运行”或“运行一次”执行 MVApp。

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

文本：

此参数包含写入文件的文本。此文本可定义为字符串、数字或者包含两者的混合 tuple。默认情况下此参数为空。这表示，您必须通过将文本直接键入输入字段或使用来自前面一个工具的可用文本结果来定义文本，例如，读取文本和数字。

您可以将前一工具的一个具体结果连接到此参数的连接器。因此，如果您想要将两个或多个工具结果的组合写入文件，首先必须使用工具评估表达式创建一个包含组合数据的 tuple。

创建目录：

此参数定义 MERLIC 是否创建参数“文件名称”中指定的目录（如果该目录还不存在）。默认情况下，此参数设置为 0，这意味着不会创建任何目录。如果此参数设置为 1，并且在“文件名称”中指定的目录不存在，MERLIC 将在执行 MVApp 后立即创建缺少的目录。

其他参数

文件句柄：

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

模式：

此参数定义了数据写入选定文件的模式。默认情况下设置为“覆盖”。您可以在相应的连接器中选择下列模式。如果“文件句柄”与之前的工具建立连接，此参数无效。

值	描述
覆盖	如果选择此模式，打开文件进行写入时“文本”参数中的数据将覆盖选定文件中的所有数据。如果“连接”参数设为 1，文件会被打开以便写入。之前的数据将会丢失。如需多次覆盖文件，每次都必须将参数“连接”设置为 0，然后再设置为 1。
附加	如果选择此模式，“文本”参数中的数据将添加在选定文件的数据后面。因此，之前的数据不会丢失。

值

描述

覆盖

如果选择此模式，打开文件进行写入时“文本”参数中的数据将覆盖选定文件中的所有数据。

如果“连接”参数设为 1，文件会被打开以便写入。之前的数据将会丢失。如需多次覆盖文件，每次都必须将参数“连接”设置为 0，然后再设置为 1。

附加

如果选择此模式，“文本”参数中的数据将添加在选定文件的数据后面。

因此，之前的数据不会丢失。

分隔符：

此参数定义了写入文件的“文本”中数据之间添加的分隔符类型。默认情况下设置为“空格”。您可以在相应的连接器中选择下列分隔符类型。

值	描述
空格	写入文件的数据的分隔符：空格。
逗号	写入文件的数据的分隔符：逗号。
分号	写入文件的数据的分隔符：分号。
点	写入文件的数据的分隔符：点。
冒号	写入文件的数据的分隔符：冒号。
制表符	写入文件的数据的分隔符：制表符。
无	写入文件的数据没有分隔符。

添加新行：

此参数定义了在写入文件的文本中，结尾是否添加新的一行。默认情况下，此参数设置为 1。这意味着在数据之间添加新的一行。如果您要将所有数据写入同一条行，将该值设置为 0。

结果

基本结果

当前文件名称：

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

工具状态：

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

其他结果

使用的文件句柄：

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

除了此结果以外，此工具没有在 MERLIC 中可见的更多结果。实际结果是写入文本的文件。

处理时间:

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

应用程序示例

此工具用于以下 MERLIC Vision App 示例：

measure_distance_to_center_led.mvapp