HOWTO · Arduino
在 Arduino 中拆分字符串
可以使用 Arduino 中的 substring() 函数拆分字符串。
本页内容
Arduino 没有一个 String 方法可以直接返回包含所有字段的数组。已知范围时,可以用 substring() 提取内容;分隔符位置未知时,可以用 indexOf() 查找;也可以用 C 函数 strtok() 对可写字符数组进行分词。手动解析循环能让你控制空字段和多个分隔符的处理方式。选择方法时,应考虑位置是否已知、输入是否可以修改,以及分隔符应如何处理。
下面的完整草图使用 Arduino 的 String 和 Serial API。当未定义 ARDUINO 时,小型主机端兼容层可让同一份草图作为标准 C++ 运行;在开发板上,这些 API 则由 Arduino 核心库提供。这里显示的串口输出由草图生成。
在 Arduino 中使用 substring() 按索引提取内容
如果要提取的范围已知,可以使用 substring(begin, end)。起始索引包含在结果中,结束索引不包含。因此,对于 "Hello,World",索引 0 到 4 组成 Hello,结束参数应为 5。像 substring(begin) 这样只传一个参数的调用,会从该索引提取到字符串末尾。
运行以下草图:
本节中的代码以及显示的标签或输出仍为英文。
#ifdef ARDUINO
#include <Arduino.h>
#else
#include <iostream>
#include <string>
class String {
public:
String(const char *value) : value_(value) {}
int indexOf(char target) const {
const auto position = value_.find(target);
return position == std::string::npos ? -1 : static_cast<int>(position);
}
int indexOf(char target, unsigned int fromIndex) const {
const auto position = value_.find(target, fromIndex);
return position == std::string::npos ? -1 : static_cast<int>(position);
}
int lastIndexOf(char target) const {
const auto position = value_.rfind(target);
return position == std::string::npos ? -1 : static_cast<int>(position);
}
String substring(unsigned int begin, unsigned int end) const {
return String(value_.substr(begin, end - begin).c_str());
}
String substring(unsigned int begin) const {
return String(value_.substr(begin).c_str());
}
const char *c_str() const { return value_.c_str(); }
private:
std::string value_;
};
struct HostSerial {
void begin(unsigned long) {}
void println(const String &value) { std::cout << value.c_str() << '\n'; }
void println(const char *value) { std::cout << value << '\n'; }
};
HostSerial Serial;
#endif
#include <cstring>
void setup() {
Serial.begin(9600);
String greeting = "Hello,World";
Serial.println(greeting.substring(0, 5));
String record = "sensor1:value1";
int separator = record.indexOf(':');
if (separator != -1) {
Serial.println(record.substring(0, separator));
}
String recordWithoutColon = "sensor1";
int absentSeparator = recordWithoutColon.indexOf(':');
if (absentSeparator == -1) {
Serial.println("delimiter not found");
} else {
Serial.println(recordWithoutColon.substring(0, absentSeparator));
}
String lines = "hello world\nGreetings\nPeople";
int finalNewline = lines.lastIndexOf('\n');
String finalLine = finalNewline == -1
? lines
: lines.substring(finalNewline + 1);
Serial.println(finalLine);
String oneLine = "single line";
int noNewline = oneLine.lastIndexOf('\n');
String onlyLine = noNewline == -1 ? oneLine : oneLine.substring(noNewline + 1);
Serial.println(onlyLine);
char names[] = "Alice,Bob,Charlie,David";
for (char *token = std::strtok(names, ","); token != nullptr;
token = std::strtok(nullptr, ",")) {
Serial.println(token);
}
String fields = "red,green,blue";
unsigned int start = 0;
while (true) {
int nextSeparator = fields.indexOf(',', start);
if (nextSeparator == -1) {
Serial.println(fields.substring(start));
break;
}
Serial.println(fields.substring(start, nextSeparator));
start = nextSeparator + 1;
}
}
void loop() {}
#ifndef ARDUINO
int main() {
setup();
return 0;
}
#endif
Hello
sensor1
delimiter not found
People
single line
Alice
Bob
Charlie
David
red
green
blue
主机端兼容层只用于通过通用 C++ 编译器检查草图逻辑,并不模拟实体开发板或 Arduino 硬件。选择 Arduino 时,条件代码会使用核心库实际提供的 String 和 Serial 实现。草图会在提取前检查 indexOf(),并在 lastIndexOf('\n') == -1 时改用完整的单行字符串。
使用 indexOf() 查找分隔符并提取字段
如果分隔符的位置不固定,可以调用 indexOf(),并将返回的位置用作 substring() 的结束索引。找不到指定字符或文本时,Arduino 会返回 -1。将结果传给 substring() 之前,先检查是否为 -1;否则该结果不能作为有效的字段边界。
例如,对于 String record = "sensor1:value1",查找 ':'。如果返回值非负,record.substring(0, separator) 会提取出 sensor1。如果字符串中没有冒号,应明确决定是将整条记录视为一个字段,还是拒绝这条记录。要提取多个字段,可以从上一个分隔符之后的位置开始重复查找。
从多行字符串中提取最后一行
使用 lastIndexOf('\n') 查找最后一个换行符,然后从它后一个字符的位置开始提取。如果从换行符本身开始,结果会包含换行符,可能使串口输出看起来多出一个空行。如果字符串中没有换行符,lastIndexOf() 会返回 -1;应单独处理这种情况,例如把完整字符串视为唯一的一行。
如果字符串依次包含 hello world、Greetings 和 People,每段文字各占一行,那么最后一行的提取起点是 lastIndexOf('\n') + 1,结果文本为 People。
使用 strtok() 对可变字符数组进行分词
strtok() 首次调用时接收一个可写的、以空字符结尾的字符数组。它找到词元时,会将数组中的分隔符替换为空字符,因此不要传入字符串字面量,也不要假设原数组会保持不变。调用 strtok(nullptr, delimiters) 可以继续扫描同一个数组;当它返回 nullptr 时停止。
分隔符参数表示一组独立字符,而不是一个多字符分隔序列。例如,":|" 会在每个冒号或竖线处进行分割。连续分隔符会被跳过,因此 strtok() 不会保留空字段。如果需要保留空字段或原始输入,请使用手动解析。
使用手动解析循环拆分带分隔符的文本
当文本格式需要实现分词器不支持的规则时,手动循环会很有用。查找分隔符,处理它之前的范围,然后将下一个起始位置移到该分隔符之后。循环结束后,即使输入末尾没有分隔符,也要处理剩余的后缀;这样才能包含示例中的最后一个字段。
如果有多个分隔符字符,就逐个检查字符是否属于选定的分隔符集合,并明确规定相邻分隔符是否表示空字段。要保留空字段,应处理相邻分隔符之间长度为零的范围,而不是直接跳过。要保留原始输入,可以从 Arduino String 原文读取而不作修改,或者在使用会修改内容的分词器前复制字符数组。
选择合适的方法并处理边界情况
位置固定时使用 substring();需要先查找分隔符时使用 indexOf();需要定位最后一次出现的位置时使用 lastIndexOf()。如果字符数组可以被修改,而且允许丢弃空字段,那么简单的词元流可以使用 strtok()。如果格式对多个分隔符、空字段或保留输入有明确要求,手动循环会更合适。
提取字段前,先决定缺少分隔符时应如何处理,并检查结果是否为 -1。还要记住,Arduino 的 substring() 结束索引不包含在结果中;从换行符之后提取文本时,通常应排除换行符本身。做好这些选择,才能确保结果恰好包含所需字符。