Diferencia entre revisiones de «Serial.println()»

De ArduWiki
Saltar a: navegación, buscar
(Sintaxis)
(Comentarios)
 
(No se muestran 12 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 
== Descripcion ==
 
== Descripcion ==
 +
Vuelca o envía textualmente el valor de una cadena de carateres o variable al puerto serie, seguido de un carácter de retorno de carro "CR" (ASCII 13, o '\r') y un carácter de salto de línea "LF"(ASCII 10, o '\n'). Toma la misma forma que el comando [[Serial.print()]].
  
 
== Sintaxis ==
 
== Sintaxis ==
 
<pre>
 
<pre>
 +
Serial.println();
 
Serial.println("Texto a mostrar");
 
Serial.println("Texto a mostrar");
 
Serial.println(variable[, formato]);
 
Serial.println(variable[, formato]);
 +
Serial.println(variable[, decimales]);
 
</pre>
 
</pre>
 +
 +
== Parámetros ==
 +
;variable: variable a evaluar.
 +
;formato: por omision es DEC, pero también puede ser [[DEC / BIN / HEX / OCT|HEX, OCT o BIN]].
 +
;decimales: eliges el numero de decimales a mostrar de una variable tipo [[float]]
 +
 +
También se puede prescindir de parámetros, sería para solamente crear el salto de línea.
 +
 +
== Retorna ==
 +
size_t ([[long]]): '''println()''' devuelve el número de bytes escritos, aunque leer ese número es opcional.
 +
 +
== Comentarios ==
 +
Los literales de caracteres y cadenas también pueden representar caracteres especiales que son difíciles o imposibles de expresar de otra manera en el código fuente de un programa, como "nueva linea" (\n) o "tab" (\t). Estos caracteres especiales son todos precedidos por un carácter de barra diagonal inversa (\).
 +
 +
{| class="wikitable col1cen"
 +
|+Codigos de escape
 +
!Código!!Descripción!!ASCII!!DEC
 +
|-
 +
|\n||nueva línea||LF||10
 +
|-
 +
|\r||retorno de carro||CR||13
 +
|-
 +
|\t||tabulacion horizontal||HT||9
 +
|-
 +
|\v||tabulacion vertical||VT||11
 +
|-
 +
|\b||retroceso||BS||8
 +
|-
 +
|\f||salto de página||FF||12
 +
|-
 +
|\a||alerta (pitido)||BELL||7
 +
|-
 +
|\'||comilla simple||'||39
 +
|-
 +
|\"||comillas dobles||"||34
 +
|-
 +
|\?||signo de interrogación||?||63
 +
|-
 +
|\\||barra invertida||\||47
 +
|}
 +
 +
== Advertencias ==
 +
Nada
  
 
== Ejemplo 1 ==
 
== Ejemplo 1 ==
 +
<syntaxhighlight lang="c++">
 +
Serial.println("ArduWiki");    //ArduWiki
 +
Serial.println(digital(13));    //Imprime 0 o 1.
 +
Serial.println(analogRead(A0)); //Imprime entre 0~1024.
 +
 +
float n = 1.23456;
 +
Serial.println(n);            //Imprime 1.23456
 +
Serial.println(n, 0);          //Imprime 1
 +
Serial.println(n, 2);          //Imprime 1.23
 +
Serial.println(n, 4);          //Imprime 1.2345
 +
</syntaxhighlight>
 +
 +
== Ejemplo 2 ==
 
En este ejemplo demostramos que a una cadena se le puede '''concatenar''' un numero sin problemas.
 
En este ejemplo demostramos que a una cadena se le puede '''concatenar''' un numero sin problemas.
  
Línea 21: Línea 80:
 
       Serial.println(m);
 
       Serial.println(m);
 
   }
 
   }
 +
}
 +
</syntaxhighlight>
 +
 +
== Ejemplo 3 ==
 +
Podemos usar la [[Asignación condicional]] dentro de println()
 +
 +
<syntaxhighlight lang="c++">
 +
void setup(){
 +
  Serial.begin(9600);
 +
  for (byte n=2; n<14; n++){
 +
      pinMode(n, INPUT);
 +
  }
 +
}
 +
void loop(){
 +
  for (byte n=2; n<14; n++){
 +
      Serial.print(n);
 +
      Serial.print(" = ");
 +
      Serial.println(digitalRead(n)?"Prendido":"Apagado");
 +
  }
 +
  Serial.println("---------");
 +
  delay(1000);
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Vea tambien ==
 
== Vea tambien ==
* [[Serial.begin()]]
+
<categorytree mode=all>Serial</categorytree>
* [[Serial.print()]]
+
 
* [[Serial.write()]]
+
== Referencias ==
* [[Serial.read()]]
 
  
[[Category:Funciones]]
+
[[Category:Serial]]

Revisión actual del 22:22 14 oct 2019

Descripcion

Vuelca o envía textualmente el valor de una cadena de carateres o variable al puerto serie, seguido de un carácter de retorno de carro "CR" (ASCII 13, o '\r') y un carácter de salto de línea "LF"(ASCII 10, o '\n'). Toma la misma forma que el comando Serial.print().

Sintaxis

Serial.println();
Serial.println("Texto a mostrar");
Serial.println(variable[, formato]);
Serial.println(variable[, decimales]);

Parámetros

variable
variable a evaluar.
formato
por omision es DEC, pero también puede ser HEX, OCT o BIN.
decimales
eliges el numero de decimales a mostrar de una variable tipo float

También se puede prescindir de parámetros, sería para solamente crear el salto de línea.

Retorna

size_t (long): println() devuelve el número de bytes escritos, aunque leer ese número es opcional.

Comentarios

Los literales de caracteres y cadenas también pueden representar caracteres especiales que son difíciles o imposibles de expresar de otra manera en el código fuente de un programa, como "nueva linea" (\n) o "tab" (\t). Estos caracteres especiales son todos precedidos por un carácter de barra diagonal inversa (\).

Codigos de escape
Código Descripción ASCII DEC
\n nueva línea LF 10
\r retorno de carro CR 13
\t tabulacion horizontal HT 9
\v tabulacion vertical VT 11
\b retroceso BS 8
\f salto de página FF 12
\a alerta (pitido) BELL 7
\' comilla simple ' 39
\" comillas dobles " 34
\? signo de interrogación ? 63
\\ barra invertida \ 47

Advertencias

Nada

Ejemplo 1

Serial.println("ArduWiki");     //ArduWiki
Serial.println(digital(13));    //Imprime 0 o 1.
Serial.println(analogRead(A0)); //Imprime entre 0~1024.

float n = 1.23456;
Serial.println(n);             //Imprime 1.23456
Serial.println(n, 0);          //Imprime 1
Serial.println(n, 2);          //Imprime 1.23
Serial.println(n, 4);          //Imprime 1.2345

Ejemplo 2

En este ejemplo demostramos que a una cadena se le puede concatenar un numero sin problemas.

void setup() {
   Serial.begin(9600);
}

void loop(){
   if (Serial.available()){
      String m = "ASCII: ";
      m = m + Serial.read();
      Serial.println(m);
   }
}

Ejemplo 3

Podemos usar la Asignación condicional dentro de println()

void setup(){
   Serial.begin(9600);
   for (byte n=2; n<14; n++){
      pinMode(n, INPUT);
   }
}
void loop(){
   for (byte n=2; n<14; n++){
      Serial.print(n);
      Serial.print(" = ");
      Serial.println(digitalRead(n)?"Prendido":"Apagado");
   }
   Serial.println("---------");
   delay(1000);
}

Vea tambien


Referencias