Belajar

String Arduino: teks yang bisa kamu gabung, bandingkan, dan pisahkan

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: pesan berjalan di LCD 16x2live0.000 s 0.00x
Klik untuk membukanya di editor
Baris bawah mencetak char array dari titik awal yang bergerak, sehingga teksnya meluncur melintasi layar.

Arduino punya dua jenis teks. String, dengan S besar, adalah objek yang bisa membesar sesuai kebutuhanmu: gabungkan dua String dengan +, bandingkan dengan ==, dan ubah "42" menjadi angka 42 dengan toInt(). Char array, seperti char name[] = "Mokxi";, adalah jenis lama dari C: deretan karakter yang diakhiri dengan satu byte nol. Kebanyakan pemula ingin String; kebanyakan library memberimu char array.

Rangkaian di atas adalah LCD 16 kali 2 pada sebuah Uno. Tekan Jalankan. Baris atas menampilkan "Mokxi LCD1602" dan baris bawah menggulir "Hello from the Uno!" melintasi layar, satu huruf demi satu huruf. Pesannya adalah char array, dan sketch-nya mencetak pesan itu dari huruf awal yang berbeda setiap 300 ms.

Di bawah ini adalah cara membuat, menggabungkan, mengubah, membandingkan, dan memecah String, empat kesalahan yang mencetak hal yang salah atau menghentikan build, dan bagaimana char array tersusun, masing-masing dijalankan pada Uno beserta hasil cetaknya.

Pesan yang bergulir adalah array berisi huruf

Ini adalah sketch yang berjalan di atas. MESSAGE menyimpan 22 huruf dan spasi, dan compiler menambahkan satu byte nol di ujungnya, jadi sizeof(MESSAGE) - 1 adalah jumlah hurufnya. Setiap putaran, loop mencetak 16 di antaranya mulai dari start, dan % length kembali ke awal, sehingga akhir pesan bersambung dengan awalnya.

Ubah teks di antara tanda petik dan tekan Jalankan, maka LCD akan menggulir kata-katamu. Biarkan tiga spasi di ujungnya; itu adalah jeda sebelum pesan kembali ke awal.

firmware/uno/examples/sflcd (sketch yang berjalan di atas)
const char MESSAGE[] = "Hello from the Uno!   ";
int start = 0;

void setup() {
  lcd.begin(16, 2);
  lcd.print("Mokxi LCD1602");
  Serial.begin(9600);
  Serial.println("Mokxi Uno: LCD1602 on pins 4, 6 and 10 to 13");
}

void loop() {
  int length = sizeof(MESSAGE) - 1;
  lcd.setCursor(0, 1);
  for (int i = 0; i < 16; i++) lcd.print(MESSAGE[(start + i) % length]);
  start = (start + 1) % length;
  delay(300);
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Membuat String dan menggabungkannya

String dibuat dari teks dalam tanda petik ganda, dan + menggabungkannya dengan teks lain, String lain, atau angka yang dibungkus String(). Sketch di bawah mencetak "Hello, Mokxi!" beserta length()-nya, 13. += menambahkan ke akhir String yang sudah kamu punya: "Count: 5" menjadi "Count: 5 lamps".

String() juga menulis angka sesuai permintaanmu. String(3.14159, 3) mencetak 3.142, dengan tiga angka di belakang koma. String(255, HEX) mencetak ff dan String(5, BIN) mencetak 101, yang berguna untuk menampilkan register sensor atau bit dari sebuah byte.

Menggabungkan teks dan angka
void setup() {
  Serial.begin(9600);
  String name = "Mokxi";
  String greeting = "Hello, " + name + "!";
  Serial.println(greeting);
  Serial.println(greeting.length());
  int count = 5;
  String line = "Count: " + String(count);
  Serial.println(line);
  line += " lamps";
  Serial.println(line);
  Serial.println(String(3.14159, 3));
  Serial.println(String(255, HEX));
  Serial.println(String(5, BIN));
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Tanda + yang tidak menggabungkan

+ hanya menggabungkan kalau salah satu sisinya adalah String. Teks dalam tanda petik sendirian adalah char array, dan menambahkan angka ke sana hanya menggeser posisinya. String line = "Count: " + count; dengan count bernilai 5 melewati lima huruf pertama dan mencetak ": ". Clang memperingatkan: adding 'int' to a string does not append to the string. Perbaikannya seperti di atas: "Count: " + String(count).

Dua potongan teks bertanda petik tidak bisa dijumlahkan sama sekali. String both = "Hello" + "World"; menghentikan build: clang mengatakan invalid operands to binary expression ('const char[6]' dan 'const char[6]'), dan GCC milik Arduino IDE mengatakan invalid operands of types 'const char [6]' and 'const char [6]' to binary 'operator+'. Jadikan yang pertama sebuah String, String("Hello") + "World", dan sisanya ikut.

Tanda petiknya juga penting. Tanda petik tunggal untuk satu karakter, 'A'. String s = 'hi'; menghentikan build dengan no viable conversion from 'int' to 'String', setelah peringatan tentang multi-character character constant. Teks selalu ditulis dalam tanda petik ganda.

String ke int, dan sebaliknya

toInt() membaca angka di awal sebuah String. String a = "42"; lalu a.toInt() + 1 mencetak 43. Ia berhenti di karakter pertama yang bukan bagian dari angka, jadi "12abc" menghasilkan 12, ia melewati spasi di depan, jadi " 7" menghasilkan 7, dan memberi 0 kalau tidak ada angka sama sekali: "abc" menghasilkan 0. toFloat() melakukan hal yang sama dengan angka desimal, dan "3.75" yang digandakan mencetak 7.50.

toInt() mengembalikan sebuah long, jadi bisa membaca angka besar, tapi variabel tempatmu menyimpannya juga harus cukup besar. "99999" mencetak 99999 langsung dari toInt(), dan -31073 setelah disimpan dalam int, yang pada Uno berhenti di 32767. Simpan di long. Untuk arah sebaliknya, angka menjadi String dengan String(42).

Teks menjadi angka
void setup() {
  Serial.begin(9600);
  String a = "42";
  Serial.println(a.toInt() + 1);
  Serial.println(String("12abc").toInt());
  Serial.println(String("abc").toInt());
  Serial.println(String(" 7").toInt());
  String t = "3.75";
  float f = t.toFloat();
  Serial.println(f * 2);
  Serial.println(String("99999").toInt());
  int n = String("99999").toInt();
  Serial.println(n);
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Membandingkan String, dan char array

== membandingkan dua String huruf demi huruf, dan huruf besar dihitung: "ON" == "on" mencetak 0, salah. equalsIgnoreCase() mencetak 1, atau panggil toLowerCase() pada String itu dulu baru bandingkan. compareTo() mengurutkan kata secara alfabetis: "apple" dibandingkan dengan "banana" hasilnya kurang dari nol.

Pada char array, == tidak membandingkan hurufnya sama sekali; ia bertanya apakah keduanya tersimpan di tempat yang sama. char word[] = "on"; lalu if (word == "on") mencetak "different". Clang memperingatkan: result of comparison against a string literal is unspecified (use an explicit string comparison function instead). Fungsi itu adalah strcmp(), yang mengembalikan 0 kalau keduanya sama: strcmp(word, "on") == 0 mencetak "strcmp: same".

Membandingkan
void setup() {
  Serial.begin(9600);
  String cmd = "ON";
  Serial.println(cmd == "on");
  Serial.println(cmd.equalsIgnoreCase("on"));
  cmd.toLowerCase();
  Serial.println(cmd == "on");
  char word[] = "on";
  if (word == "on") Serial.println("same");
  else Serial.println("different");
  if (strcmp(word, "on") == 0) Serial.println("strcmp: same");
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Memecah satu baris: indexOf() dan substring()

Sensor atau board lain sering mengirim beberapa nilai dalam satu baris dengan koma sebagai pemisah, misalnya "21.5,48,1013". indexOf(',') mencari posisi koma pertama, di sini 4, dan indexOf(',', first + 1) mencari koma berikutnya setelahnya. substring(from, to) memotong bagian di antaranya, dari from sampai sebelum to, dan toFloat() atau toInt() mengubah setiap bagian menjadi angka. Sketch di bawah mencetak 21.50, 48 dan 1013.

indexOf() mengembalikan -1 kalau tidak menemukan apa pun, jadi periksa itu dulu sebelum memotong. Beberapa lainnya yang sering muncul: charAt(0) atau data[0] adalah satu karakter, replace("l", "L") mengubah "Hello" menjadi "HeLLo", toUpperCase() membuatnya "HELLO", dan trim() membuang spasi dan akhir baris dari kedua ujung, yang seperti ditunjukkan di halaman baca serial sering menjadi yang dibutuhkan sebuah perbandingan.

Tiga nilai dari satu baris
void setup() {
  Serial.begin(9600);
  String data = "21.5,48,1013";
  int first = data.indexOf(',');
  int second = data.indexOf(',', first + 1);
  float temp = data.substring(0, first).toFloat();
  int humidity = data.substring(first + 1, second).toInt();
  long pressure = data.substring(second + 1).toInt();
  Serial.println(temp);
  Serial.println(humidity);
  Serial.println(pressure);
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

char array, dan nol di ujungnya

char name[] = "Mokxi"; menyimpan lima huruf dan satu byte lagi, nol, yang menandai akhirnya. sizeof(name) mencetak 6 dan strlen(name), yang menghitung sampai nol itu, mencetak 5. Setiap huruf adalah entri seperti array lainnya: name[0] mencetak M, dan setelah name[0] = 'm'; nama itu mencetak "mokxi".

String dan char array bisa saling dikonversi. String s = name; membuat String dari array, dan s.c_str() menyerahkan String ke fungsi yang menginginkan char array, seperti banyak fungsi library.

String menyimpan hurufnya di memori yang dimintanya selama sketch berjalan, dan mengembalikannya setelah selesai. Pada Uno, dengan 2048 byte RAM untuk semuanya, sketch yang membuat String panjang berulang kali di loop() bisa kekurangan memori setelah berjam-jam berjalan. Untuk pesan singkat itu bukan masalah. Untuk sketch yang berjalan berhari-hari, simpan teks di char array atau panggil reserve() sekali di setup(); halaman memori rendah punya penjelasan selanjutnya.

Buka rangkaian ini di editor. Arduino Uno: pesan bergulir di LCD 16x2, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apa bedanya String dan string di Arduino?

String dengan huruf S besar adalah objek Arduino yang bisa kamu gabungkan dengan +, bandingkan dengan == dan konversi dengan toInt(). string dengan huruf kecil biasanya berarti char array, seperti char name[] = "Mokxi";, yaitu barisan karakter yang diakhiri byte nol.

Bagaimana cara mengubah String menjadi int di Arduino?

Panggil toInt() padanya: String("42").toInt() hasilnya 42. Fungsi itu mengembalikan long dan memberi 0 saat teksnya tidak dimulai dengan angka. Gunakan toFloat() untuk desimal.

Bagaimana cara menggabungkan String dengan angka?

Bungkus angkanya dalam String(): "Count: " + String(count). Tanpa itu, "Count: " + count akan menggeser teks sebanyak count huruf alih-alih menggabungkan, dan mencetak sebagiannya.

Bagaimana cara membandingkan dua string di Arduino?

Dua String dibandingkan dengan ==, dan huruf besar dihitung beda; gunakan equalsIgnoreCase() untuk mengabaikannya. Untuk char array gunakan strcmp(a, b) == 0, karena == pada char array membandingkan lokasi penyimpanannya, bukan isinya.

Bagaimana cara memecah String dengan koma?

Temukan setiap koma dengan indexOf(','), potong bagiannya dengan substring(), lalu konversi dengan toInt() atau toFloat(). Contoh di halaman ini membaca tiga nilai dari "21.5,48,1013".

Bagaimana cara mendapat panjang sebuah String di Arduino?

`s.length()` menghitung jumlah karakternya: "Hello" yang ditambah " world" mencetak 11. Untuk char array, `strlen(c)` juga memberi 11, sedangkan `sizeof(c)` memberi 12, karena juga menghitung byte nol yang mengakhiri teks.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.