Diferencia entre revisiones de «Stream.print()»

De ArduWiki
Saltar a: navegación, buscar
(Página creada con «== Descripción == == Sintaxis == <pre> </pre> == Parametros == == Retorna == == Advertencias == Nada. == Ejemplo == <syntaxhighlight lang="c++"> </syntaxhighlight> =...»)
 
Línea 1: Línea 1:
 
== Descripción ==
 
== Descripción ==
 +
Vuelca o envía un dato (variable, número o cadena), al puerto serie; lo hace mediante la representación textual de su valor. Dicho comando puede tomar diferentes formas, dependiendo de los parámetros que usemos para definir el formato de volcado de los datos.
  
 
== Sintaxis ==
 
== Sintaxis ==
 
<pre>
 
<pre>
 +
objetoStream.print("texto a mostrar");
 +
objetoStream.print(variable, formato);
 
</pre>
 
</pre>
  
 
== Parametros ==
 
== Parametros ==
 +
;variable: variable a evaluar. Esta variable puede ser de cualquier tipo.
 +
;formato: por defecto es '''DEC''', pero puedes también usar '''HEX''', '''OCT''' o '''BIN'''. También puede ser un valor del 0 al 7 si '''variable''' es un punto flotante, representaría la cantidad de cifras decimales a imprimir.
 +
 +
También se pueden utilizar cadenas de caracteres en memoria [[flash]], definidas dentro de [[F()]].
  
 
== Retorna ==
 
== Retorna ==
 +
La cantidad de caracteres que se llegaron a enviar en el proceso ([[long]]).
  
 
== Advertencias ==
 
== Advertencias ==
 
Nada.
 
Nada.
 +
 +
== 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
 +
|-
 +
|\n||nueva línea
 +
|-
 +
|\r||retorno de carro
 +
|-
 +
|\t||lengüeta
 +
|-
 +
|\v||pestaña vertical
 +
|-
 +
|\b||retroceso
 +
|-
 +
|\f||alimentación de formulario (alimentación de página)
 +
|-
 +
|\a||alerta (pitido)
 +
|-
 +
|\'||comilla simple ( ')
 +
|-
 +
|\"||comillas dobles ( ")
 +
|-
 +
|\?||signo de interrogación ( ?)
 +
|-
 +
|\\||barra invertida ( \)
 +
|}
  
 
== Ejemplo ==
 
== Ejemplo ==
 
<syntaxhighlight lang="c++">
 
<syntaxhighlight lang="c++">
 +
Serial.print(F("Fecha de compilacion: "));
 +
Serial.println(F(__DATE__));
 +
Serial.print(F("Hora de compilacion: "));
 +
Serial.println(F(__TIME__));
 +
// __DATE__ y __TIME__ son definiciones implícitas en todo boceto de Arduino; son cadenas de caracteres que represetan la fecha y hora de la compilación del código.
 +
// Ya que una definición de cadena equivale a const char*, es aceptado en F() para no consumir RAM.
 +
</syntaxhighlight>
 +
 +
<syntaxhighlight lang="c++">
 +
byte c = 'A';          //Serial lo mismo que c = 65
 +
Serial.write(c);      //A  ***ojo al piojo***
 +
Serial.print(c);      //65
 +
Serial.print(c, DEC);  //65
 +
Serial.print(c, HEX);  //41
 +
Serial.print(c, OCT);  //101
 +
Serial.print(c, BIN);  //1000001
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Revisión del 22:42 11 jul 2018

Descripción

Vuelca o envía un dato (variable, número o cadena), al puerto serie; lo hace mediante la representación textual de su valor. Dicho comando puede tomar diferentes formas, dependiendo de los parámetros que usemos para definir el formato de volcado de los datos.

Sintaxis

objetoStream.print("texto a mostrar");
objetoStream.print(variable, formato);

Parametros

variable
variable a evaluar. Esta variable puede ser de cualquier tipo.
formato
por defecto es DEC, pero puedes también usar HEX, OCT o BIN. También puede ser un valor del 0 al 7 si variable es un punto flotante, representaría la cantidad de cifras decimales a imprimir.

También se pueden utilizar cadenas de caracteres en memoria flash, definidas dentro de F().

Retorna

La cantidad de caracteres que se llegaron a enviar en el proceso (long).

Advertencias

Nada.

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
\n nueva línea
\r retorno de carro
\t lengüeta
\v pestaña vertical
\b retroceso
\f alimentación de formulario (alimentación de página)
\a alerta (pitido)
\' comilla simple ( ')
\" comillas dobles ( ")
\? signo de interrogación ( ?)
\\ barra invertida ( \)

Ejemplo

Serial.print(F("Fecha de compilacion: "));
Serial.println(F(__DATE__));
Serial.print(F("Hora de compilacion: "));
Serial.println(F(__TIME__));
// __DATE__ y __TIME__ son definiciones implícitas en todo boceto de Arduino; son cadenas de caracteres que represetan la fecha y hora de la compilación del código.
// Ya que una definición de cadena equivale a const char*, es aceptado en F() para no consumir RAM.
byte c = 'A';          //Serial lo mismo que c = 65
Serial.write(c);       //A   ***ojo al piojo***
Serial.print(c);       //65
Serial.print(c, DEC);  //65
Serial.print(c, HEX);  //41
Serial.print(c, OCT);  //101
Serial.print(c, BIN);  //1000001

Vea también

Referencias