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() 结束索引不包含在结果中;从换行符之后提取文本时,通常应排除换行符本身。做好这些选择,才能确保结果恰好包含所需字符。