扫描文件
- 更新时间2026-02-19
- 阅读时长6分钟
扫描文件文本中的字符串、数值、路径和布尔数据,使文本转换为数据类型,返回重复的引用句柄及转换后的输出,该输出结果以扫描的先后顺序排列。该函数不可用于LLB中的文件。

输入/输出
格式字符串
—
格式字符串指定如何使输入字符串转换为输出参数。 默认状态下,依据输出连线的数据类型的默认设置搜索字符串。右键单击函数,在快捷菜单中选择编辑扫描字符串,可创建或编辑格式字符串。 该输入端最多支持255个字符。
输入文件
—
输入文件可以是引用句柄或绝对文件路径。 如为引用句柄,节点可打开引用句柄指定的文件。如指定的文件不存在,函数可创建该文件。默认状态将显示文件对话框并提示用户选择文件。 如指定空路径或相对路径,函数可返回错误。
错误输入
—
错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。
默认值1
—
默认1..n指定输出参数的类型和默认值。 函数无法从格式字符串扫描到输入值时可使用默认值。如未连线默认1且格式字符串为常量,函数通过格式字符串确定输出类型。否则,输出接线的默认数据类型为双精度浮点型。依据输出数据类型,默认值可以为0或空字符串。如默认1连接的是枚举型,函数可在枚举型中查找与字符串值相匹配的子字符串,并返回枚举型的相应数值。 使用字符串格式代码或数值格式代码时函数可以扫描布尔值。如果格式代码为 %s 或未接线,函数会将 Y、 T、 TRUE、 ON或 YES 以及这些单词的任何小写版本读作 TRUE 布尔值。该函数将 F、 FALSE、 OFF或 NO 以及这些单词的任何小写版本读作 FALSE 布尔值。如指定的是数值格式代码,函数将读取任何大于0.5的数值为TRUE,任何小于等于0.5的数值为FALSE。
备注 该函数读取负数为FALSE布尔值,因为此时函数将负数转换为一个无符号8位整型,而任何小于等于0.5的数值在转换中都将变为0。
输出文件引用句柄
—
输出文件引用句柄是VI读取的文件的引用句柄。 依据对文件的不同操作,可连线该输入端至其它文件函数。如通过文件路径引用或文件对话框选定文件,默认状态下可关闭文件。如输入文件为引用句柄,LabVIEW可假定文件仍在使用,直至关闭文件。
错误输出
—
错误输出包含错误信息。该输出提供标准错误输出功能。
输出1
—
输出1..n指定输出参数。 输出可以是字符串、路径、枚举类型、时间标识、布尔或任意数值数据类型。如扫描字符串不适合指定的数值数据类型,函数可返回适合该数据类型的最大值。函数不能用于数组和簇。 |
右键单击函数,在快捷菜单中选择添加参数,或调整函数大小都可添加函数中参数的数量。
如连线程序框图常量字符串至格式字符串接线端,LabVIEW可在编译时依据格式化字符串的输入确定输出的个数以及每个输出的数据类型。如输出连线的类型与格式字符串指定的数据类型不符,则必须修改输出的类型使VI正常运行。
如未直接连线程序框图常量至格式字符串,LabVIEW可在运行时检查类型不匹配。如需扫描双精度、浮点之外的数据类型,则必须连线数据类型至默认1..n。
如未使用固定格式说明符%[^...](常用于读取整个字符串中的匹配字符),则匹配的字符留在文件流中。%[^\n\r]匹配整行文本,但回车和新的一行位于后面。如需删除此类字符,可使用%[^\n\r]\n\r。
字符串格式化范例
| 输入字符串 | 格式字符串 | 默认值 | 输出 | 剩余字符串 |
|---|---|---|---|---|
abc, xyz >12.3+56i 7200 | %3s, %s%f%2d | — | abc | 00 |
| — | xyz | |||
| 0+00i | 12.3+56i | |||
| — | 72 | |||
| Q+1.27E-3 tail | Q%f t | — | 1.27E-3 | ail |
| 0123456789 | %3d%3d | — | 12 | 6789 |
| 345 | ||||
| X:9.860 Z:3.450 | X:%fY:%f | 100 (I32) | 10 | Z: 3450 |
| 100.00 (DBL) | 100.00 | |||
| set49.4.2 | set%d | — | 49 | .4.2 |
| color: red | color:%s | blue (enum {red, green, blue}) | red | — |
| abcd012xyz3 | %[a-z]%d %[a-z]%d | — | abcd | — |
| 12 | ||||
| xyz | ||||
| 3 | ||||
| welcome to LabVIEW, John Smith | %[^,],%s | — | welcome to LabVIEW | Smith |
| John |
范例
请参考LabVIEW附带的下列示例文件。
- labview\examples\File IO\Text (ASCII)\Format Into File and Scan From File.vi
格式字符串
—
输入文件
—
错误输入
—
默认值1
—
输出文件引用句柄
—
错误输出
—
输出1
—