从字节流文件中读取指定数目的字符或行。该函数不可用于LLB中的文件。


icon

输入/输出

  • cstr.png 对话框窗口（打开现有文件） —

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

  • cpath.png 文件（使用对话框） —

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

    如果是路径，函数将打开路径指定的文件。默认状态将显示文件对话框并提示用户选择文件。

    如指定空或相对路径，或者文件不存在，函数将返回错误。

  • ci32.png 计数 —

    计数是函数读取的字符数或行数的最大值。

    如提前到达文件结尾，函数实际读取的字符数和行数小于最大值。如计数<0，函数读取从当前位置开始的整个文件。如勾选快捷菜单上的读取行，则只读取一行；如取消勾选该菜单项，则读取整个文件。
    注： 如连线至总数的文件大小的数据类型不是32位整型，LabVIEW将强制转换数据类型为32位整型。VI不读取指定数量的数据。如连线–1至总数且要读取的文件太大，无法表示为32位整数，LabVIEW可返回错误。
  • cerrcodeclst.png 错误输入 —

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

  • ibsrn.png 引用句柄输出 —

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

  • istr.png 文本 —

    文本是从文件读取的文本。默认状态下，该字符串中包含从文件第一行读取的字符。如连线计数接线端，则参数为字符串数组，包含从文件读取的行。如右键单击函数并取消勾选快捷菜单的读取行，则参数为字符串，其中包含从文件读取的字符。

  • ibool.png 取消 —

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

    否则，即使函数返回错误，取消的值仍为FALSE。
  • ierrcodeclst.png 错误输出 —

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

    • 该函数以只读方式打开文件。如连线函数的引用句柄输出至执行写入操作函数的文件输入端，LabVIEW将返回权限错误。此时，可使用打开/创建/替换文件函数以默认的读取/写入权限打开文件，然后连线引用句柄至执行读取或写入操作的函数。

    默认情况下，该函数从文本文件中读取所有字符。连线整数值至计数接线端，可指定从第一个字符起要读取的字符的数量。右键单击函数，在快捷菜单中勾选读取行选项，可从文本文件中读取单独的行。快捷菜单中读取行选项选中时，连线整数值至计数输入端，可指定从第一行开始起要读取的行的数量。如在计数中输入值-1，将从文本文件中读取所有字符和行。

    使用“设置文件位置”函数可进行随机访问。

    如未通过右键单击函数在快捷菜单中取消勾选转换EOL选项，该函数将把所有基于平台的行结束符转换为换行符。如连线路径至文件，该函数可打开文件，读取内容，然后关闭文件。

    范例

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

    • labview\examples\File IO\Text (ASCII)\Write to Text File and Read from Text File.vi