HOWTO · Arduino

Arduino에서 문자열 분할

Arduino에서 substring() 함수를 사용하여 문자열을 분할할 수 있습니다.

이 페이지의 내용

Arduino에는 모든 필드를 배열로 반환하는 단일 String 메서드가 없습니다. 범위가 정해진 문자열은 substring()로 추출하고, 위치를 모르는 구분자는 indexOf()로 찾을 수 있습니다. 쓰기 가능한 문자 배열은 C 함수 strtok()로 토큰화할 수 있습니다. 직접 파싱 루프를 작성하면 빈 필드와 여러 구분자를 원하는 방식으로 처리할 수 있습니다. 위치가 정해져 있는지, 입력을 수정해도 되는지, 구분자를 어떻게 처리해야 하는지에 따라 방법을 선택하세요.

다음 전체 스케치는 Arduino의 String 및 Serial API를 사용합니다. 호스트 측 호환성 계층 덕분에 ARDUINO가 정의되지 않은 경우에도 같은 스케치를 표준 C++로 실행할 수 있으며, 보드에서는 Arduino 코어가 해당 API를 제공합니다. 여기에 표시된 직렬 출력 줄은 스케치가 생성합니다.

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()에 전달하기 전에 확인하세요. 확인하지 않으면 유효한 필드 경계로 사용할 수 없습니다.

예를 들어 String record = "sensor1:value1"에서 ':'의 위치를 찾을 수 있습니다. 결과가 0 이상이면 record.substring(0, separator)로 sensor1을 추출합니다. 콜론이 없다면 전체 레코드를 하나의 필드로 취급할지 입력을 거부할지 명시적으로 정하세요. 필드가 여러 개라면 이전 구분자 다음 문자부터 검색을 반복하면 됩니다.

여러 줄 문자열에서 마지막 줄 추출하기

lastIndexOf('\\n')로 마지막 줄바꿈 위치를 찾은 다음, 그 위치에서 한 문자 뒤부터 추출하세요. 줄바꿈 문자부터 추출하면 결과에 줄바꿈이 포함되어 직렬 출력에 빈 줄이 있는 것처럼 보일 수 있습니다. 줄바꿈이 없다면 lastIndexOf()는 -1을 반환합니다. 이 경우에는 전체 문자열을 한 줄로 취급하는 등 별도로 처리하세요.

hello world, Greetings, People이 각각 다른 줄에 있는 문자열에서는 lastIndexOf('\\n') + 1 위치부터 마지막 줄을 추출하며, 결과는 People입니다.

수정 가능한 문자 배열을 strtok()로 토큰화하기

strtok()를 처음 호출할 때는 쓰기 가능한 널 종료 문자 배열을 전달해야 합니다. 토큰을 찾으면서 배열의 구분자를 널 문자로 바꾸므로 문자열 리터럴을 전달하거나 원래 배열이 그대로 유지될 것으로 기대하지 마세요. 같은 배열을 계속 검색하려면 strtok(nullptr, delimiters)를 호출하고, nullptr가 반환되면 중단하세요.

구분자 인수는 여러 문자로 된 하나의 구분 문자열이 아니라 개별 문자의 집합입니다. 예를 들어 ":|"는 콜론이나 파이프가 나올 때마다 나눕니다. 연속된 구분자는 건너뛰므로 strtok()는 빈 필드를 보존하지 않습니다. 빈 필드나 원본 입력을 유지해야 한다면 직접 파싱하세요.

직접 파싱 루프로 구분된 텍스트 나누기

토크나이저가 제공하지 않는 규칙이 필요한 형식에는 직접 루프를 작성하는 방법이 유용합니다. 구분자를 찾아 그 앞의 범위를 처리한 다음, 다음 시작 위치를 구분자 뒤로 옮기세요. 입력이 구분자로 끝나지 않더라도 루프가 끝난 뒤 나머지 부분을 처리해야 예제의 마지막 필드까지 포함됩니다.

구분자가 여러 종류라면 각 문자가 선택한 구분자 집합에 속하는지 확인하고, 인접한 구분자를 빈 필드로 볼지 정하세요. 빈 필드를 보존하려면 건너뛰지 말고 인접한 구분자 사이의 길이 0인 범위를 처리하세요. 원본을 보존하려면 원래 Arduino String을 수정하지 않고 읽거나, 수정하는 토크나이저를 사용하기 전에 문자 배열을 복사하세요.

방법 선택 및 예외 상황 처리

위치가 고정되어 있다면 substring()를, 먼저 구분자를 찾아야 한다면 indexOf()를, 마지막으로 나타나는 위치가 중요하다면 lastIndexOf()를 사용하세요. 문자 배열을 수정해도 되고 빈 필드를 버려도 되는 간단한 토큰 흐름에는 strtok()가 적합합니다. 여러 구분자, 빈 필드 또는 입력 보존에 관한 규칙이 필요하면 직접 루프를 작성하는 편이 낫습니다.

필드를 추출하기 전에 구분자가 없을 때 어떻게 처리할지 정하고 -1인지 확인하세요. Arduino의 substring()에서 끝 인덱스는 범위에 포함되지 않으며, 줄바꿈 뒤의 텍스트를 추출할 때는 일반적으로 줄바꿈 문자를 결과에서 제외해야 합니다. 이러한 선택에 따라 결과에 의도한 문자만 정확히 포함되는지가 달라집니다.