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()에서 끝 인덱스는 범위에 포함되지 않으며, 줄바꿈 뒤의 텍스트를 추출할 때는 일반적으로 줄바꿈 문자를 결과에서 제외해야 합니다. 이러한 선택에 따라 결과에 의도한 문자만 정확히 포함되는지가 달라집니다.