Arduino strtok: tách văn bản và phân tích lệnh từ serial
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
strtok() tách một mảng char thành các phần tại các ký tự bạn chỉ định, chẳng hạn dấu phẩy hoặc dấu cách. Lời gọi đầu tiên nhận mảng, mỗi lời gọi sau nhận NULL và tiếp tục từ chỗ lần trước dừng lại, và nó trả về NULL khi không còn gì. Nó làm việc trên chuỗi C thuần chứ không phải String, nên nó dùng ít bộ nhớ và phù hợp với những dòng ngắn mà cảm biến hoặc serial monitor gửi.
Mạch ở trên là một Uno trả lại đúng những gì bạn gõ, từng byte một. Gõ "on" rồi Enter, nó in ra "you typed: o (0x6F)", "you typed: n (0x6E)" và "you typed: <newline>". Các byte đến từng cái một, nên sketch phải gom chúng thành một dòng trước, rồi mới tách dòng đó.
Dưới đây là cách tách các giá trị phân tách bằng dấu phẩy thành số, strtok làm gì với mảng của bạn, vì sao String cần một bản sao, một bộ phân tích lệnh điều khiển LED, và strtok_r cho việc tách trong một lần tách. Để tách String bằng indexOf() và substring() thay thế, xem trang String.
Muốn học từng bước? Bài học "Nhận lệnh" sẽ hướng dẫn bạn qua từng điểm kiểm tra.
Mở bài họcTách các giá trị phân tách bằng dấu phẩy thành mảng
Gọi strtok(line, ",") một lần để lấy phần đầu, rồi strtok(NULL, ",") trong một vòng lặp cho đến khi nó trả về NULL, chuyển từng phần bằng atof() cho số thập phân hoặc atoi() cho số nguyên. Sketch dưới đây in ra "3 values", sau đó "21.50", "48.00" và "1013.00".
Dừng lại theo kích thước mảng của bạn, giống như count < 3 làm: một dòng có nhiều dấu phẩy hơn bạn dự kiến không được phép ghi vượt quá phần cuối mảng.
The last line shows what strtok leaves behind. It printed "line is now: 21.5". strtok writes a zero over each comma it finds, so the array now ends after the first piece. Copy the line first if you need it again.
void setup() {
Serial.begin(9600);
char line[] = "21.5,48,1013";
float values[3];
int count = 0;
char *piece = strtok(line, ",");
while (piece != NULL && count < 3) {
values[count] = atof(piece);
count++;
piece = strtok(NULL, ",");
}
Serial.print(count);
Serial.println(" values");
for (int i = 0; i < count; i++) {
Serial.println(values[i]);
}
Serial.print("line is now: ");
Serial.println(line);
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Các trường rỗng biến mất
strtok coi một chuỗi dấu phẩy liền nhau là một, nên trường rỗng bị bỏ qua thay vì được trả về rỗng. Cùng sketch đó với "5,,7" in ra "2 values", 5.00 và 7.00: số 7 đã chuyển sang vị trí thứ hai. Khi một trường có thể trống, hãy kiểm tra số lượng, hoặc gửi 0 thay vì bỏ trống.
strtok cần một mảng char, không phải String
strtok changes the text it splits, so it takes a char *. Giving it a String’s text with strtok(line.c_str(), ",") stopped the build with no matching function for call to 'strtok', and the note says 1st argument ('const char *') would lose const qualifier: c_str() is read only. The Arduino IDE’s GCC says invalid conversion from 'const char*' to 'char*'.
Hãy sao chép String vào một mảng char trước bằng toCharArray(). Sketch dưới đây in ra "21.5" và "48". Một chuỗi trong ngoặc kép viết thẳng vào lời gọi, strtok("21.5,48", ","), chỉ nhận một cảnh báo, ISO C++11 does not allow conversion from string literal to 'char *', và của GCC là ISO C++ forbids converting a string constant to 'char*'. Nó chạy được ở đây và in ra 21.5, nhưng đừng dựa vào điều đó: văn bản trong ngoặc kép là phải giữ nguyên, mà strtok lại ghi vào nó.
void setup() {
Serial.begin(9600);
String line = "21.5,48";
char buf[32];
line.toCharArray(buf, sizeof(buf));
char *piece = strtok(buf, ",");
while (piece != NULL) {
Serial.println(piece);
piece = strtok(NULL, ",");
}
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Một bộ phân tích lệnh serial
Sketch dưới đây gom các byte vào một bộ đệm 32 byte cho đến khi gặp ký tự xuống dòng, rồi tách dòng tại các dấu cách thành một lệnh và hai tham số, và so sánh lệnh bằng strcmp(). Nó hiểu "led 13 on", "led 12 off" và "blink 11 3". Những lệnh khác cũng nhận được câu trả lời, nên gõ sai cũng không bao giờ bị bỏ qua.
Chúng tôi đã gõ năm dòng: led 13 on, led 12 on, led 13 off, blink 11 3 và hello. Nó in ra "pin 13 on", "pin 12 on", "pin 13 off", "blinked 3 times" và "unknown: hello", và để LED ở chân 12 sáng. Kiểm tra len < sizeof(buf) - 1 loại bỏ mọi thứ quá 31 ký tự thay vì ghi vượt quá bộ đệm, và phép kiểm tra \r giúp nó hoạt động bất kể monitor gửi kết thúc dòng kiểu nào. Để nhận cả dấu phẩy lẫn dấu cách giữa các từ, hãy cho strtok " ," làm dấu phân tách thay vì " ".
char buf[32];
byte len = 0;
void setup() {
Serial.begin(9600);
pinMode(13, OUTPUT);
pinMode(12, OUTPUT);
pinMode(11, OUTPUT);
Serial.println("ready");
}
void runCommand(char *line) {
char *cmd = strtok(line, " ");
char *arg1 = strtok(NULL, " ");
char *arg2 = strtok(NULL, " ");
if (cmd == NULL) return;
if (strcmp(cmd, "led") == 0 && arg1 && arg2) {
int pin = atoi(arg1);
digitalWrite(pin, strcmp(arg2, "on") == 0 ? HIGH : LOW);
Serial.print("pin ");
Serial.print(pin);
Serial.print(" ");
Serial.println(arg2);
} else if (strcmp(cmd, "blink") == 0 && arg1 && arg2) {
int pin = atoi(arg1);
int times = atoi(arg2);
for (int i = 0; i < times; i++) {
digitalWrite(pin, HIGH);
delay(100);
digitalWrite(pin, LOW);
delay(100);
}
Serial.print("blinked ");
Serial.print(times);
Serial.println(" times");
} else {
Serial.print("unknown: ");
Serial.println(cmd);
}
}
void loop() {
while (Serial.available() > 0) {
char c = Serial.read();
if (c == '\r') continue;
if (c == '\n') {
buf[len] = '\0';
runCommand(buf);
len = 0;
} else if (len < sizeof(buf) - 1) {
buf[len++] = c;
}
}
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Tách trong một lần tách: strtok_r
strtok nhớ vị trí của nó trong một biến ẩn duy nhất, nên nó chỉ có thể xử lý được một dòng tại một thời điểm. Tách "temp=21;hum=48;lux=310" tại dấu chấm phẩy, và mỗi cặp tại dấu bằng bằng strtok nữa, thì in ra "temp -> 21" rồi dừng: các lời gọi bên trong làm mất vị trí của lời gọi bên ngoài.
strtok_r nhận vị trí làm đối số thứ ba, nên mỗi cấp giữ vị trí riêng của mình. Phiên bản dưới đây in ra "temp -> 21", "hum -> 48" và "lux -> 310". Dùng strtok_r mỗi khi một hàm tách văn bản có thể được gọi từ bên trong một lần tách khác.
void setup() {
Serial.begin(9600);
char line[] = "temp=21;hum=48;lux=310";
char *outer;
char *pair = strtok_r(line, ";", &outer);
while (pair != NULL) {
char *inner;
char *key = strtok_r(pair, "=", &inner);
char *value = strtok_r(NULL, "=", &inner);
Serial.print(key);
Serial.print(" -> ");
Serial.println(atoi(value));
pair = strtok_r(NULL, ";", &outer);
}
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Mở mạch này trong trình soạn thảo. Arduino Uno: trả lại những gì serial monitor gửi, được nối như khi nó chạy ở đầu trang này. Thay đổi một linh kiện hoặc một giá trị rồi chạy lại.
Câu hỏi
strtok hoạt động như thế nào trong Arduino?
The first call, strtok(line, ","), returns the first piece of a char array; each later call, strtok(NULL, ","), returns the next, and NULL means there are no more. It replaces each separator in the array with a zero as it goes.
Tôi có thể dùng strtok với String không?
Không trực tiếp được: c_str() chỉ đọc mà strtok ghi vào văn bản, nên quá trình biên dịch dừng lại. Hãy sao chép String vào mảng char bằng toCharArray() rồi tách mảng đó.
Vì sao strtok bỏ qua trường rỗng của tôi?
Nó coi hai dấu phân tách liền nhau là một, nên "5,,7" cho hai phần, không phải ba. Hãy kiểm tra có bao nhiêu phần được trả về, hoặc gửi 0 cho giá trị thiếu.
Làm thế nào để phân tích lệnh từ serial monitor?
Collect bytes into a char array until a newline, end it with a zero, split it at spaces with strtok, and compare the first piece with strcmp(). The parser on this page does it for LED commands.
Sự khác nhau giữa strtok và strtok_r là gì?
strtok giữ vị trí của nó trong một biến ẩn duy nhất, nên hai lần tách cùng lúc sẽ cản trở nhau. strtok_r nhận vị trí làm đối số, nên tách trong một lần tách vẫn hoạt động được.
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.