扫描文件文本中的字符串、数值、路径和布尔数据，使文本转换为数据类型，返回重复的引用句柄及转换后的输出，该输出结果以扫描的先后顺序排列。该函数不可用于LLB中的文件。

该函数可扫描文件中的所有文本。但是，该函数无法判断扫描开始的起点。如需判断扫描开始的起点，可使用读取文本文件和扫描字符串函数。


icon

输入/输出

  • cstr.png 格式字符串 —

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

    默认状态下，依据输出连线的数据类型的默认设置搜索字符串。右键单击函数，在快捷菜单中选择编辑扫描字符串，可创建或编辑格式字符串。

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

  • cbsrn.png 输入文件 —

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

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

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

  • cerrcodeclst.png 错误输入 —

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

  • cdbl.png 默认值6 —

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

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

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

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

  • idbl.png 输出4 —

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

    注： 如果发生错误， 错误输出 簇的 源 组件包含一个 "从文件扫描（参数 n） "形式的字符串 ， 其中 n 是发生错误的第一个参数。

    如连线程序框图常量字符串至格式字符串接线端，LabVIEW可在编译时依据格式化字符串的输入确定输出的个数以及每个输出的数据类型。如输出连线的类型与格式字符串指定的数据类型不符，则必须修改输出的类型使VI正常运行。

    如未直接连线程序框图常量至格式字符串，LabVIEW可在运行时检查类型不匹配。如需扫描双精度、浮点之外的数据类型，则必须连线数据类型至默认1..n。

    如未使用固定格式说明符%[^...]（常用于读取整个字符串中的匹配字符），则匹配的字符留在文件流中。%[^\n\r]匹配整行文本，但回车和新的一行位于后面。如需删除此类字符，可使用%[^\n\r]\n\r。

    注： 默认状态下，该函数可识别区域设置，即函数使用操作系统区域设置中配置的系统小数点分隔符。某些情况下（例如，在欧洲的操作系统上使用GPIB仪器），则可能需要使用本地化的代码语法元素取代当前的系统小数点分隔符。

    字符串格式化范例

    输入字符串格式字符串默认值输出剩余字符串

    abc, xyz

    >12.3+56i 7200

    		%3s, %s%f%2d—abc00
    —xyz
    0+00i12.3+56i
    —72
    Q+1.27E-3 tailQ%f t—1.27E-3ail
    0123456789%3d%3d—126789
    345
    X:9.860 Z:3.450X:%fY:%f100 (I32)10Z: 3450
    100.00 (DBL)100.00
    set49.4.2set%d—49.4.2
    color: redcolor:%sblue (enum {red, green, blue})red—
    abcd012xyz3

    %[a-z]%d

    %[a-z]%d

    		—abcd—
    12
    xyz
    3
    welcome to LabVIEW, John Smith%[^,],%s—welcome to LabVIEWSmith
    John

    范例

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

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