Aprender

Strings no Arduino: texto que você pode juntar, comparar e desmontar

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: uma mensagem rolando em um LCD 16x2ao vivo0.000 s 0.00x
Clique para abrir no editor
A linha de baixo imprime um vetor de chars a partir de um início que se move, então o texto desliza pela tela.

O Arduino tem dois tipos de texto. Uma String, com S maiúsculo, é um objeto que cresce conforme você precisa: junte duas com +, compare-as com == e transforme "42" no número 42 com toInt(). Um array de char, como char name[] = "Mokxi";, é o tipo mais antigo do C: uma fileira de caracteres que termina em um byte zero. A maioria dos iniciantes quer String; a maioria das bibliotecas te entrega arrays de char.

O circuito acima é um LCD 16 por 2 em um Uno. Aperte Rodar. A linha de cima mostra "Mokxi LCD1602" e a de baixo rola "Hello from the Uno!" de um lado para o outro, uma letra por vez. A mensagem é um array de char, e o sketch a imprime começando por uma letra diferente a cada 300 ms.

Abaixo está como criar, juntar, converter, comparar e dividir Strings, os quatro erros que imprimem a coisa errada ou param a compilação, e como um array de char é organizado na memória, cada um rodando em um Uno com o que ele imprimiu.

A mensagem que rola é um array de letras

Aqui está o sketch que roda acima. MESSAGE guarda 22 letras e espaços, e o compilador adiciona um byte zero no final, então sizeof(MESSAGE) - 1 é o número de letras. A cada volta, o loop imprime 16 delas começando em start, e % length volta ao início, então o fim da mensagem encontra o começo dela.

Troque o texto entre as aspas e aperte Rodar, e o LCD rola as suas palavras. Deixe os três espaços no final; eles são o intervalo antes de a mensagem voltar ao começo.

firmware/uno/examples/sflcd (o sketch que roda acima)
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);
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Criar uma String e juntá-la

Uma String é criada a partir de texto entre aspas duplas, e + a junta com mais texto, outra String ou um número envolvido em String(). O sketch abaixo imprimiu "Hello, Mokxi!" e o length() dele, 13. += adiciona ao final de uma String que você já tem: "Count: 5" virou "Count: 5 lamps".

String() também escreve números do jeito que você pedir. String(3.14159, 3) imprimiu 3.142, com três casas. String(255, HEX) imprimiu ff e String(5, BIN) imprimiu 101, o que é útil para mostrar o registrador de um sensor ou os bits de um byte.

Juntar texto e números
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() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

O + que não junta

O + só junta quando um dos lados é uma String. Texto entre aspas sozinho é um array de char, e somar um número a ele avança ao longo dele. String line = "Count: " + count; com count em 5 pulou as cinco primeiras letras e imprimiu ": ". O Clang avisou: adding 'int' to a string does not append to the string. A correção é a de cima: "Count: " + String(count).

Dois pedaços de texto entre aspas não podem ser somados de jeito nenhum. String both = "Hello" + "World"; parou a compilação: o clang diz invalid operands to binary expression ('const char[6]' and 'const char[6]'), e o GCC da IDE do Arduino diz invalid operands of types 'const char [6]' and 'const char [6]' to binary 'operator+'. Transforme o primeiro em String, String("Hello") + "World", e o resto segue.

As aspas também importam. Aspas simples servem para um caractere, 'A'. String s = 'hi'; parou a compilação com no viable conversion from 'int' to 'String', depois de um aviso sobre uma constante de caractere múltiplo. Texto sempre vai entre aspas duplas.

String para int, e voltando

toInt() lê o número no começo de uma String. String a = "42"; então a.toInt() + 1 imprimiu 43. Ele para no primeiro caractere que não faz parte de um número, então "12abc" deu 12, ele pula espaços na frente, então " 7" deu 7, e devolve 0 quando não há número nenhum: "abc" deu 0. toFloat() faz o mesmo com decimais, e "3.75" dobrado imprimiu 7.50.

toInt() devolve um long, então consegue ler números grandes, mas a variável em que você o guarda também tem que ser grande o suficiente. "99999" imprimiu 99999 direto do toInt(), e -31073 depois de ser guardado em um int, que em um Uno para em 32767. Guarde em um long. No outro sentido, um número vira uma String com String(42).

Texto para números
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() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Comparar Strings, e arrays de char

== compara duas Strings letra por letra, e maiúsculas contam: "ON" == "on" imprimiu 0, falso. equalsIgnoreCase() imprimiu 1, ou chame toLowerCase() na String antes e depois compare. compareTo() coloca palavras em ordem alfabética: "apple" comparada com "banana" é menor que zero.

Com arrays de char, == não compara as letras de jeito nenhum; ele pergunta se estão guardadas no mesmo lugar. char word[] = "on"; então if (word == "on") imprimiu "different". O Clang avisou: result of comparison against a string literal is unspecified (use an explicit string comparison function instead). Essa função é strcmp(), que devolve 0 quando as duas são iguais: strcmp(word, "on") == 0 imprimiu "strcmp: same".

Comparando
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() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Dividir uma linha: indexOf() e substring()

Um sensor ou outra placa costuma enviar vários valores em uma linha com vírgulas entre eles, como "21.5,48,1013". indexOf(',') encontra onde está a primeira vírgula, 4 aqui, e indexOf(',', first + 1) encontra a próxima depois dela. substring(from, to) recorta a parte entre elas, de from até, mas sem incluir, to, e toFloat() ou toInt() transforma cada parte em um número. O sketch abaixo imprimiu 21.50, 48 e 1013.

indexOf() devolve -1 quando não encontra nada, então verifique isso antes de recortar. Mais alguns que aparecem: charAt(0) ou data[0] é um caractere, replace("l", "L") transformou "Hello" em "HeLLo", toUpperCase() deixou "HELLO", e trim() tira espaços e fins de linha das duas pontas, o que, como a página de leitura serial mostra, é muitas vezes o que uma comparação precisa.

Três valores de uma linha
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() {
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Arrays de char, e o zero no final

char name[] = "Mokxi"; guarda cinco letras e mais um byte, um zero, que marca o fim. sizeof(name) imprimiu 6 e strlen(name), que conta até o zero, imprimiu 5. Cada letra é uma entrada como em qualquer array: name[0] imprimiu M, e depois de name[0] = 'm'; o nome imprimiu "mokxi".

Uma String e um array de char se convertem nos dois sentidos. String s = name; cria uma String a partir do array, e s.c_str() entrega uma String a uma função que quer um array de char, como muitas funções de biblioteca fazem.

Uma String guarda suas letras em memória que ela pede enquanto o sketch roda, e devolve quando termina. Em um Uno, com 2048 bytes de RAM para tudo, um sketch que cria Strings longas repetidamente no loop() pode ficar sem memória depois de horas rodando. Para mensagens curtas, não há com o que se preocupar. Para um sketch que roda por dias, mantenha o texto em arrays de char ou chame reserve() uma vez no setup(); a página sobre memória baixa tem o resto.

Abra este circuito no editor. Arduino Uno: uma mensagem rolando em um LCD 16x2, ligado como ele roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Qual é a diferença entre String e string no Arduino?

String com S maiúsculo é o objeto do Arduino que você pode juntar com +, comparar com == e converter com toInt(). Uma string com s minúsculo geralmente é um array de char, como char name[] = "Mokxi";, uma sequência de caracteres terminada em um byte zero.

Como converter uma String em um int no Arduino?

Chame toInt() nela: String("42").toInt() é 42. Ela retorna um long e dá 0 quando o texto não começa com um número. Use toFloat() para decimais.

Como juntar uma String e um número?

Coloque o número dentro de String(): "Count: " + String(count). Sem isso, "Count: " + count avança ao longo do texto em count letras em vez de juntar, e imprime parte dele.

Como comparar duas strings no Arduino?

Duas Strings se comparam com ==, e maiúsculas contam; use equalsIgnoreCase() para ignorá-las. Para arrays de char use strcmp(a, b) == 0, porque == em arrays de char compara onde eles estão guardados, e não o que dizem.

Como dividir uma String por vírgulas?

Encontre cada vírgula com indexOf(','), recorte os pedaços com substring() e converta-os com toInt() ou toFloat(). O exemplo desta página lê três valores de "21.5,48,1013".

Como obter o comprimento de uma String no Arduino?

`s.length()` conta os caracteres: "Hello" com " world" adicionado imprimiu 11. Para um array de char, `strlen(c)` dá 11 também, enquanto `sizeof(c)` dá 12, porque também conta o byte zero que termina o texto.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.