strtok في Arduino: تقسيم النص وتحليل أوامر الشاشة التسلسلية
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
الدالة strtok() تقسّم مصفوفة char إلى قطع عند المحارف التي تحددها، مثل الفواصل أو المسافات. النداء الأول يأخذ المصفوفة، وكل نداء بعده يأخذ NULL ويكمل من حيث توقف النداء السابق، ويعيد NULL عندما لا يبقى شيء. وهي تعمل على نص C العادي وليس على String، لذا تستهلك ذاكرة قليلة وتناسب الأسطر القصيرة التي يرسلها حساس أو الشاشة التسلسلية.
الدائرة في الأعلى هي لوحة Uno تعيد كتابة ما تكتبه، بايتًا واحدًا في كل مرة. عندما كتبنا "on" وضغطنا Enter، طبع "you typed: o (0x6F)" و "you typed: n (0x6E)" و "you typed: <newline>". تصل البايتات واحدًا تلو الآخر، لذا يجمعها الكود في سطر أولًا، ثم يقسّمها.
في الأسفل كيفية تقسيم قيم مفصولة بفواصل إلى أرقام، وما تفعله strtok بمصفوفتك، ولماذا تحتاج String إلى نسخة، ومحلل أوامر يشغّل ويطفئ LED، و strtok_r لتقسيم داخل تقسيم. لتقسيم String باستخدام indexOf() و substring() بدلًا من ذلك، انظر صفحة String.
تريد النسخة خطوة بخطوة؟ الدرس "تلقّي الأوامر" يشرح ذلك مع نقاط تحقق.
افتح الدرستقسيم قيم مفصولة بفواصل إلى مصفوفة
نادِ strtok(line, ",") مرة واحدة للحصول على أول قطعة، ثم strtok(NULL, ",") في حلقة حتى تعيد NULL، محولًا كل قطعة ب atof() للأعداد العشرية أو atoi() للأعداد الصحيحة. الكود في الأسفل طبع "3 values" ثم "21.50" و "48.00" و "1013.00".
توقف عند حجم مصفوفتك، كما يفعل الشرط count < 3: سطر فيه فواصل أكثر مما توقعت يجب ألّا يكتب بعد نهاية المصفوفة.
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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
الحقول الفارغة تختفي
تعامل strtok سلسلة من الفواصل كفاصلة واحدة، فتتخطى الحقل الفارغ بدل إعادته فارغًا. الكود نفسه مع "5,,7" طبع "2 values" و 5.00 و 7.00: انتقل 7 إلى الموضع الثاني. عندما يمكن أن يكون الحقل فارغًا، تحقق من العدد، أو أرسل 0 بدلًا من لا شيء.
تحتاج strtok إلى مصفوفة char، وليس 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*'.
انسخ String إلى مصفوفة char أولًا باستخدام toCharArray(). الكود في الأسفل طبع "21.5" و "48". النص المقتبس المكتوب مباشرة في النداء، strtok("21.5,48", ",")، لم يحصل إلا على تحذير، ISO C++11 does not allow conversion from string literal to 'char *'، وصياغة GCC هي ISO C++ forbids converting a string constant to 'char*'. عمل هنا وطبع 21.5، لكن لا تعتمد عليه: النص بين علامتي اقتباس مقصود أن يبقى كما هو، و strtok تكتب فيه.
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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
محلل أوامر تسلسلية
يجمع الكود في الأسفل البايتات في مخزن مؤقت حجمه 32 بايت حتى سطر جديد، ثم يقسّم السطر عند المسافات إلى أمر ووسيطين ويقارن الأمر ب strcmp(). يفهم "led 13 on" و "led 12 off" و "blink 11 3". وأي شيء آخر يحصل على رد أيضًا، فالخطأ المطبعي لا يمر بصمت أبدًا.
كتبنا خمسة أسطر: led 13 on، و led 12 on، و led 13 off، و blink 11 3، و hello. طبع "pin 13 on" و "pin 12 on" و "pin 13 off" و "blinked 3 times" و "unknown: hello"، وترك LED الطرف 12 مضيئًا. الفحص len < sizeof(buf) - 1 يرمي أي شيء بعد 31 محرفًا بدل الكتابة بعد نهاية المخزن المؤقت، واختبار \r يجعله يعمل مع أي نهاية سطر ترسلها الشاشة. لقبول الفواصل إلى جانب المسافات بين الكلمات، أعطِ strtok الفواصل " ," بدلًا من " ".
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;
}
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
تقسيم داخل تقسيم: strtok_r
تحتفظ strtok بمكانها في متغير خفي واحد، لذا لا تستطيع العمل على أكثر من سطر في كل مرة. تقسيم "temp=21;hum=48;lux=310" عند الفواصل المنقوطة، وكل زوج عند علامة يساوي ب strtok كذلك، طبع "temp -> 21" وتوقف: النداءات الداخلية أضاعت مكان النداء الخارجي.
تأخذ strtok_r المكان كوسيط ثالث، فيحتفظ كل مستوى بمكانه الخاص. النسخة في الأسفل طبعت "temp -> 21" و "hum -> 48" و "lux -> 310". استخدم strtok_r كلما أمكن استدعاء دالة تقسّم نصًا من داخل تقسيم آخر.
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() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
افتح هذه الدائرة في المحرر. Arduino Uno: تعيد كتابة ما ترسله الشاشة التسلسلية، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.
الأسئلة
كيف تعمل strtok في 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.
هل يمكنني استخدام strtok مع String؟
ليس مباشرة: الدالة c_str() للقراءة فقط و strtok تكتب في النص، فيتوقف البناء. انسخ String إلى مصفوفة char ب toCharArray() وقسّمها.
لماذا تتخطى strtok الحقل الفارغ عندي؟
لأنها تعامل فاصلين متتاليين كفاصل واحد، فتعطي "5,,7" قطعتين لا ثلاثًا. تحقق من عدد القطع العائدة، أو أرسل 0 مكان القيمة المفقودة.
كيف أحلّل الأوامر الواردة من الشاشة التسلسلية؟
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.
ما الفرق بين strtok و strtok_r؟
تحتفظ strtok بمكانها في متغير خفي واحد، فيتداخل تقسيمان في الوقت نفسه. أما strtok_r فتأخذ المكان كوسيط، فيعمل التقسيم داخل تقسيم.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.