扫描字符串
- 更新时间2026-02-19
- 阅读时长6分钟
扫描输入字符串,然后依据格式字符串进行转换。
明确知道输入的格式时,可使用该函数。输入可以是字符串路径、枚举型、时间标识或数值。另外,可使用扫描文件函数,在文件中扫描文本。连线板可显示该多态函数的默认数据类型。

输入/输出
格式字符串
—
格式字符串指定如何使输入字符串转换为输出参数。 默认状态下,可依据输出数据类型的默认格式扫描字符串。时间标识只能按照时间格式,否则返回错误。右键单击函数,在快捷菜单中选择编辑扫描字符串,可创建或编辑格式字符串。 格式字符串中的每个空格可匹配任意数量的空白(例如,空格、制表符、换行符和换页符)。 该输入端最多支持255个字符。
输入字符串
—
输入字符串是要扫描的字符串、路径、枚举类型、时间标识或数值。
初始扫描位置
—
初始扫描位置是字符串中的偏移量,即扫描开始的位置。 默认值为0。
错误输入
—
错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。
默认值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。
剩余字符串
—
剩余字符串返回在扫描所有参数后,剩余的字符串。
扫描后偏移量
—
扫描后偏移量是扫描完成后输入字符串的偏移量。
错误输出
—
错误输出包含错误信息。该输出提供标准错误输出功能。
输出1
—
输出1..n指定输出参数。 输出可以是字符串、路径、枚举类型、时间标识、布尔或任意数值数据类型。如扫描字符串不适合指定的数值数据类型,函数可返回适合该数据类型的最大值。函数不能用于数组和簇。 |
右键单击函数,在快捷菜单中选择添加参数,或调整函数大小都可添加函数中参数的数量。
如设置格式字符串为在输出参数中返回数值,LabVIEW可忽略输入字符串中的空格。
如连线程序框图常量字符串至格式字符串接线端,LabVIEW可在编译时依据格式化字符串的输入确定输出的个数以及每个输出的数据类型。如输出连线的类型与格式字符串指定的数据类型不符,则必须修改输出的类型使VI正常运行。
如未直接连线程序框图常量至格式字符串,LabVIEW可在运行时检查类型不匹配。如需扫描双精度、浮点之外的数据类型,则必须连线数据类型至默认1..n。
字符串格式化范例
关于格式化字符串的详细信息和范例,见格式说明符语法。
| 输入字符串 | 格式字符串 | 默认值 | 输出 | 剩余字符串 |
|---|---|---|---|---|
abc, xyz >12.3+56i 7200 | %3s, %s%f%2d | — | abc | 00 |
| — | xyz | |||
| 0.00+00i | 12.30+56.00i | |||
| — | 72 | |||
| Q+1.27E-3 tail | Q%f t | — | 1.27E-3 | ail |
| 0123456789 | %3d%3d | — | 12.00 | 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 | ||||
时间:23:15:04.25 5/31/2004 | Time: %<%H:%M:%S%2u%m/%d/%Y>T | 1/1/1904 | 下午 11:15:04.250 5/31/2004 | — |
格式字符串
—
初始扫描位置
—
错误输入
—
默认值1
—
剩余字符串
—
扫描后偏移量
—
错误输出
—
输出1
—