HOWTO · Arduino

Imprimir nueva línea en Arduino

Uno puede imprimir una nueva línea usando la función Serial.print() o Serial.println().

En esta página

Para imprimir una nueva línea en un sketch de Arduino, llama a Serial.println() después del texto o valor que deba terminar la línea. Usa Serial.print() cuando el siguiente valor deba continuar en la misma línea. También puedes pasar el carácter de nueva línea \n a Serial.print() para terminar una línea explícitamente. Inicia la comunicación serie con Serial.begin(9600) en setup() antes de enviar datos.

Usa Serial.println() para terminar una línea

Serial.println() escribe su argumento y, a continuación, añade un salto de línea. Por eso, cada llamada hace que la siguiente salida comience después de que haya terminado la línea anterior. Esto resulta útil para lecturas independientes, mensajes de estado y otros valores que se entienden mejor uno por línea.

El siguiente ejemplo independiente en C++ usa una pequeña implementación simulada de Serial para comprobar el texto capturado sin una placa Arduino. En una placa, el núcleo de Arduino proporciona Serial y llama a setup(); las llamadas del sketch que aparecen aquí son las mismas que se usan allí. Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

#include <cassert>
#include <string>

class SerialPort {
 public:
  std::string data;

  void begin(unsigned long) {}
  void print(const char* value) { data += value; }
  void print(char value) { data += value; }
  void println(const char* value) { data += value; data += '\n'; }
  void println(int value) { data += std::to_string(value); data += '\n'; }
};

SerialPort Serial;

void setup() {
  Serial.begin(9600);
  Serial.println("Arduino is ready");
}

int main() {
  setup();
  assert(Serial.data == "Arduino is ready\n");
}

La implementación simulada registra el texto y la aserción comprueba que println() añade un salto de línea. Es un modelo en C++ de las llamadas, no firmware para una placa. El caso de ejecución suministrado terminó correctamente, con código de salida 0 y salida estándar vacía: la aserción comprueba el texto capturado sin mostrarlo en la salida estándar.

Añade un salto de línea con Serial.print()

Serial.print() deja el cursor de salida después de los caracteres que escribe. Para terminar esa línea explícitamente, pasa el carácter de nueva línea \n como literal de carácter después del texto anterior. En un sketch, las llamadas serían Serial.print("Arduino is ready"); seguidas de Serial.print('\n');. La primera escribe el mensaje; la segunda escribe un salto de línea.

En C++, las comillas simples indican un carácter como '\n', mientras que las comillas dobles indican una cadena como "Arduino is ready". Esta diferencia importa: un carácter de nueva línea es un solo carácter, mientras que "\n" es una cadena que contiene ese carácter.

Imprime varios valores en líneas distintas

Puedes combinar llamadas para colocar una etiqueta junto a un valor y terminar después la línea con Serial.println(). Por ejemplo, usa Serial.print("Temperature: "); seguido de Serial.println(temperature); y repite el patrón con Serial.print("Humidity: "); y Serial.println(humidity);. Declara en el sketch los valores que vayas a usar, como int temperature = 25; e int humidity = 60;.

Cada llamada a Serial.print() escribe una etiqueta sin terminar la línea. La llamada siguiente a Serial.println() escribe el valor de la variable y termina esa línea. Se puede pasar una variable directamente; las opciones de formato numérico son independientes del comportamiento de los saltos de línea. Estas llamadas adicionales aparecen en línea, no como un segundo programa, así que el artículo no afirma que se hayan ejecutado.

Elige el método adecuado para la salida serie

Usa Serial.println(value) cuando quieras que cada mensaje o lectura ocupe su propia línea. Usa Serial.print(value) para construir una línea con varias partes y, cuando esté completa, llama a Serial.println() o a Serial.print('\n'). Serial.begin(9600) debe estar en setup() para inicializar la comunicación serie antes de que el sketch escriba en el puerto serie.

Un patrón práctico consiste en imprimir una etiqueta con Serial.print(), imprimir su valor con Serial.println() y repetirlo para la lectura siguiente. Así, las etiquetas y los valores quedan juntos y es más fácil revisar las lecturas sucesivas en el Monitor Serie. El caso de ejecución suministrado para el modelo independiente en C++ terminó correctamente, con código de salida 0 y salida estándar vacía; valida el texto capturado mediante una aserción, en lugar de mostrarlo en la salida estándar.