写入二进制数据至新文件,添加数据至现有有文件,或替换文件的内容。该函数不可用于LLB中的文件。

如需使用“读取二进制文件”函数读取写入文件的数组或字符串数据,则预置数组或字符串大小参数必须为TRUE。否则,LabVIEW将产生错误。

如数组大小超过4 GB,VI将截断数组。


icon

输入/输出

  • cbool.png 预置数组或字符串大小? (T)

    预置数组或字符串大小?表明当数据为数组或字符串时,LabVIEW是否将数据大小信息添加至文件开头。如预置数组或字符串大小?的值为FALSE,LabVIEW将不包含大小信息。

    默认值为TRUE。预置数组或字符串大小?仅控制最上层的数据大小信息。在层次结构数据类型(例如,簇)中的数组和字符串始终包括大小信息。

  • cstr.png 提示(选择或输入文件路径)

    对话框窗口是在文件对话框的文件或目录列表以及文件夹上方显示的信息。

  • cpath.png 文件(使用对话框)

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

    如连接该路径至文件输入端,函数先打开或创建文件,然后将内容写入文件并替换任何先前文件的内容。如连线文件引用句柄至文件输入端,写入操作从当前文件位置开始。如需在现有文件后添加内容,可使用设置文件位置函数,将文件位置设置在文件结尾。默认状态将显示文件对话框并提示用户选择文件。

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

  • cunclst.png 数据

    数据包含要写入文件的数据,可以是任意的数据类型。

  • cenum.png 字节顺序(0:big-endian, network order)

    字节顺序设置结果数据的endian形式。字节顺序,或endian形式,表明在内存中整数是否按照从最高有效字节到最低有效字节的形式表示,或者相反。函数必须按照数据写入的字节顺序读取数据。

    0big-endian, network order (默认)-最重要字节占用最低内存地址。该形式用于PowerPC平台(例如VxWorks)。该endian形式也在读取由其他平台上写入的数据时使用。
    1native, host order-使用主机的字节顺序格式。该形式可提高读取写速度。
    2little-endian-最低有效字节占据最低的内存地址。该形式用于Windows、macOS和Linux。
  • cerrcodeclst.png 错误输入

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

  • ibsrn.png 引用句柄输出

    引用句柄输出是函数读取的文件的引用句柄。根据对文件的不同操作,可将该输入端连线至其它文件函数。如通过文件路径引用或文件对话框选定文件,默认状态下可关闭文件。如文件是引用句柄或连线引用句柄输出至其它函数,则LabVIEW认为文件仍在使用,直至它被关闭。

  • ibool.png 取消

    取消如取消文件对话框则值为TRUE。

    否则,即使函数返回错误,取消的值仍为FALSE。

  • ierrcodeclst.png 错误输出

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

  • 使用“拒绝访问”函数,可确保写入文件时其他用户不能修改该文件。使用“设置文件位置”函数可进行随机访问。

    范例

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

    • labview\examples\File IO\Binary\Simple Binary\Simple Binary File.lvproj
    • labview\examples\File IO\Spreadsheet\Tab-Delimited Data\Buffered Stream to Tab-Delimited Text File.vi