HOWTO · Arduino
Cadena dividida en Arduino
Uno puede dividir una cadena usando la función substring() en Arduino.
En esta página
Arduino no ofrece un único método de String que devuelva una matriz con todos los campos. Puedes extraer un rango conocido con substring(), buscar un separador cuya posición desconoces con indexOf() o dividir en tokens una matriz de caracteres modificable con la función de C strtok(). Un bucle de análisis manual permite controlar los campos vacíos y los separadores múltiples. Elige el método según si conoces las posiciones, si puedes modificar la entrada y cómo deben tratarse los separadores.
El siguiente programa completo usa las API String y Serial de Arduino. Un pequeño adaptador de compatibilidad en el entorno anfitrión permite ejecutar el mismo programa como C++ estándar cuando ARDUINO no está definido; en una placa, el núcleo de Arduino proporciona esas API. Las líneas serie que se muestran aquí las genera el programa.
Usa substring() para extraer texto por índice en Arduino
Usa substring(begin, end) cuando ya conozcas el rango que quieres extraer. El índice inicial se incluye y el índice final se excluye. Así, en "Hello,World", los índices del 0 al 4 forman Hello, y el argumento final es 5. Una llamada con un solo argumento, como substring(begin), extrae desde ese índice hasta el final de la cadena.
Ejecuta este programa:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
#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
El adaptador del entorno anfitrión solo sirve para comprobar la lógica del programa con un compilador de C++ general; no emula una placa física ni el hardware de Arduino. Al compilar para Arduino, el código condicional usa las implementaciones reales de String y Serial del núcleo. El programa comprueba indexOf() antes de extraer texto y, cuando lastIndexOf('\\n') == -1, usa la cadena completa de una sola línea. El ejemplo muestra nombres, etiquetas y texto de salida en inglés; ese contenido permanece en inglés para conservar la paridad byte por byte con el código canónico.
Busca un separador con indexOf() y extrae un campo
Cuando la posición del separador varía, llama a indexOf() y usa la posición que devuelve como índice final para substring(). Arduino devuelve -1 cuando no encuentra el carácter o el texto solicitado. Comprueba ese valor antes de pasarlo a substring(); de lo contrario, no representa un límite de campo válido.
Por ejemplo, con String record = "sensor1:value1", busca ':'. Si el resultado es mayor o igual que cero, record.substring(0, separator) extrae sensor1. Si no aparece el signo de dos puntos, decide explícitamente si tratarás el registro completo como un solo campo o si lo rechazarás. Para obtener más de un campo, repite la búsqueda desde el carácter siguiente al separador anterior.
Extrae la última línea de una cadena multilínea
Usa lastIndexOf('\\n') para localizar el último salto de línea y comienza la extracción un carácter después. Si empiezas en el propio salto de línea, lo incluirás y la salida serie podría parecer que contiene una línea en blanco. Si no hay ningún salto de línea, lastIndexOf() devuelve -1; trata este caso por separado, por ejemplo, considerando que la cadena completa es la única línea.
Si una cadena contiene hello world, Greetings y People en líneas separadas, la extracción de la última línea comienza en lastIndexOf('\\n') + 1 y el texto resultante es People.
Divide en tokens una matriz de caracteres modificable con strtok()
strtok() recibe una matriz de caracteres modificable y terminada en nulo en la primera llamada. A medida que encuentra tokens, sustituye los separadores de esa matriz por caracteres nulos; por eso, no le pases un literal de cadena ni esperes que la matriz original quede intacta. Llama a strtok(nullptr, delimiters) para continuar recorriendo la misma matriz y detente cuando devuelva nullptr.
El argumento de delimitadores es un conjunto de caracteres individuales, no una secuencia de varios caracteres. Por ejemplo, ":|" separa en cada signo de dos puntos o barra vertical. Los separadores consecutivos se omiten, así que strtok() no conserva los campos vacíos. Usa el análisis manual si necesitas conservar campos vacíos o la entrada original.
Divide texto delimitado con un bucle de análisis manual
Un bucle manual resulta útil cuando el formato requiere reglas que los tokenizadores no ofrecen. Busca un separador, procesa el rango anterior y mueve el siguiente punto de inicio más allá de ese separador. Al terminar el bucle, procesa el sufijo restante aunque la entrada no termine con un separador; así se incluye el último campo del ejemplo.
Si hay varios caracteres separadores, comprueba cada carácter frente al conjunto elegido y define si los separadores adyacentes representan campos vacíos. Para conservar un campo vacío, procesa un rango de cero caracteres entre separadores adyacentes en vez de saltarlo. Para conservar la entrada original, lee la cadena String de Arduino sin modificarla o copia la matriz de caracteres antes de usar un tokenizador que la modifique.
Elige un método y trata los casos límite
Usa substring() para posiciones fijas, indexOf() cuando primero debas encontrar un separador y lastIndexOf() cuando importe la última aparición. Usa strtok() para secuencias sencillas de tokens si puedes modificar una matriz de caracteres y descartar los campos vacíos. Un bucle manual es más adecuado cuando el formato establece reglas explícitas para varios separadores, campos vacíos o la conservación de la entrada.
Antes de extraer un campo, decide qué significa que falte el separador y comprueba si el resultado es -1. Recuerda que el índice final de substring() en Arduino es exclusivo y que, por lo general, conviene excluir el salto de línea al extraer el texto que viene después. Estas decisiones determinan si el resultado contiene exactamente los caracteres deseados.