使字符串、数值、路径或布尔数据格式化为文本并写入文件。如连线文件引用句柄至文件输入端，写入操作从当前文件位置开始。如需在现有文件之后添加内容，可使用“设置文件位置”函数，设置文件位置在文件结尾。否则，函数将打开文件并在文件开始处写入文件。该函数不可用于LLB中的文件。


icon

输入/输出

  • cstr.png 格式字符串 —

    格式字符串指定如何转换输入参数。

    默认状态可匹配输入参数的数据类型。右键单击函数，在快捷菜单中选择编辑格式字符串，可编辑格式字符串。

    该输入端最多支持255个字符。

  • cpath.png 输入文件 —

    输入文件可以是引用句柄或绝对文件路径。

    如为引用句柄，节点可打开引用句柄指定的文件。如指定的文件不存在，函数可创建该文件。默认状态将显示文件对话框并提示用户选择文件。

    如指定空路径或相对路径，函数可返回错误。

  • cerrcodeclst.png 错误输入 —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • cdbl.png 输入4 —

  • ibsrn.png 输出文件引用句柄 —

    输出文件引用句柄是VI读取的文件的引用句柄。

    依据对文件的不同操作，可连线该输入端至其它文件函数。如通过文件路径引用或文件对话框选定文件，默认状态下可关闭文件。如输入文件为引用句柄，LabVIEW可假定文件仍在使用，直至关闭文件。
  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

    • 右键单击函数，在快捷菜单中选择添加参数，或调整函数大小都可添加函数中参数的数量。

    该函数可用于判断数据在文件中显示的先后顺序。

    该函数将格式字符串中的新行或\n转换为符合不同操作平台的行结束字符（例如，在Windows上为CR/LF、在macOS和Linux上则为LF）。如无需转换下一行字符，可使用格式化写入字符串函数，连线结果字符串输出端至写入文件函数的文本输入端。然后，右键单击“写入文本文件”函数，在快捷菜单项中取消勾选转换EOL。

    在格式字符串中指定使用的输入

    默认情况下，该函数按顺序将输入填入格式字符串，格式标识符为百分号代码。可使用数字以及美元符号($)来确切指定输入的位置。例如，无论格式字符串中前面有几个参数，%3$d表示使用第三个输入。

    详细范例，请参考下列程序框图：

    下列输入组合显示了$对输入顺序的影响：

    输入1输入2格式字符串输出文件中的数据说明
    firstsecond%s %sfirst second格式字符串未使用$说明符，所以函数按输入顺序填充百分号代码。
    firstsecond%2$s %1$ssecond first格式字符串使用$说明符，所以输入值的显示顺序与输入顺序不同。
    firstsecond%1$s %1$s %1$sfirst first first格式字符串使用标识符$多次使用第一个输入，而忽略第二个输入。

    除了 $ 之外，您还可以使用其他 特殊字符 来配置该函数如何在 格式字符串中填充百分数代码。

    范例

    请参考LabVIEW附带的下列范例文件。

    • labview\examples\File IO\Text (ASCII)\Format Into File and Scan From File.vi