<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>Arduino Reference - Print </title>
<link rel="shortcut icon" type="image/x-icon" href="http://arduino.cc/en/favicon.png">
<link rel='stylesheet' href='arduinoWideRender.css'
type='text/css' />
<!--HeaderText--><style type='text/css'><!--
ul, ol, pre, dl, p { margin-top:0px; margin-bottom:0px; }
code { white-space: nowrap; }
.vspace { margin-top:1.33em; }
.indent { margin-left:40px; }
.outdent { margin-left:40px; text-indent:-40px; }
a.createlinktext { text-decoration:none; border-bottom:1px dotted gray; }
a.createlink { text-decoration:none; position:relative; top:-0.5em;
font-weight:bold; font-size:smaller; border-bottom:none; }
img { border:0px; }
.editconflict { color:green;
font-style:italic; margin-top:1.33em; margin-bottom:1.33em; }
table.markup { border: 2px dotted #ccf; width:90%; }
td.markup1, td.markup2 { padding-left:10px; padding-right:10px; }
td.markup1 { border-bottom: 1px solid #ccf; }
div.faq { margin-left:2em; }
div.faq p.question { margin: 1em 0 0.75em -2em; font-weight:bold; }
div.faq hr { margin-left: -2em; }
.frame
{ border:1px solid #cccccc; padding:4px; background-color:#f9f9f9; }
.lfloat { float:left; margin-right:0.5em; }
.rfloat { float:right; margin-left:0.5em; }
a.varlink { text-decoration:none; }
/**
* GeSHi (C) 2004 - 2007 Nigel McNie, 2007 - 2008 Benny Baumann
* (http://qbnz.com/highlighter/ and http://geshi.org/)
*/
.arduino {font-family:monospace;}
.arduino .imp {font-weight: bold; color: red;}
.arduino .kw1 {color: #CC6600;}
.arduino .kw2 {color: #006699;}
.arduino .kw3 {color: #CC6600; font-weight: bold;}
.arduino .co1 {color: #7E7E7E; font-style: italic;}
.arduino .co2 {color: #7E7E7E;}
.arduino .coMULTI {color: #7E7E7E; font-style: italic;}
.arduino .es0 {color: #000099; font-weight: bold;}
.arduino .es1 {color: #000099; font-weight: bold;}
.arduino .es2 {color: #660099; font-weight: bold;}
.arduino .es3 {color: #660099; font-weight: bold;}
.arduino .es4 {color: #660099; font-weight: bold;}
.arduino .es5 {color: #006699; font-weight: bold;}
.arduino .br0 {color: #000000;}
.arduino .sy0 {color: #000000;}
.arduino .st0 {color: #0066CC;}
.arduino .nu0 {color: #000000;}
.arduino .nu6 {color: #208080;}
.arduino .nu8 {color: #208080;}
.arduino .nu12 {color: #208080;}
.arduino .nu16 {color:#800080;}
.arduino .nu17 {color:#800080;}
.arduino .nu18 {color:#800080;}
.arduino .nu19 {color:#800080;}
.arduino .me1 {color: #ff1493;}
.arduino .me2 {color: #ff1493;}
.arduino span.xtra { display:block; }
.sourceblocklink {
text-align: right;
font-size: smaller;
}
.sourceblocktext {
padding: 0.5em;
color: #000000;
background-color: #ffffff;
}
.sourceblocktext div {
font-family: monospace;
font-size: small;
line-height: 1;
height: 1%;
}
.sourceblocktext div.head,
.sourceblocktext div.foot {
font: italic medium serif;
padding: 0.5em;
}
--></style> <meta name='robots' content='index,follow' />
<meta name="verify-v1" content="TtxFIEJAB6zdJ509wLxjnapQzKAMNm9u0Wj4ho6wxIY=" />
</head>
<body>
<div id="page">
<!--PageHeaderFmt-->
<div id="pageheader">
<div class="title"><a href='http://arduino.cc/en'>Arduino</a></div>
</div>
<!--/PageHeaderFmt-->
<!--PageLeftFmt-->
<div id="pagenav">
<div id="navbar">
<p><a class='wikilink' href='http://arduino.cc/en/Main/Buy'>Buy</a>
<a class='wikilink' href='http://arduino.cc/en/Main/Software'>Download</a>
<a class='wikilink' href='Guide_index.html'>Getting Started</a>
<a class='wikilink' href='http://arduino.cc/en/Tutorial/HomePage'>Learning</a>
<a class='wikilink' href='index.html'>Reference</a>
<a class='wikilink' href='http://arduino.cc/en/Main/Hardware'>Hardware</a>
<a class='wikilink' href='FAQ.html'>FAQ</a>
</p>
<p class='vspace'></p>
</div>
</div>
<!--/PageLeftFmt-->
<div id="pagetext">
<!--PageText-->
<div id='wikitext'>
<p><a class='wikilink' href='Serial.html'>Serial</a>
</p>
<p class='vspace'></p><h2>print()</h2>
<h4>Description</h4>
<p>Prints data to the serial port as human-readable ASCII text. This command can take many forms. Numbers are printed using an ASCII character for each digit. Floats are similarly printed as ASCII digits, defaulting to two decimal places. Bytes are sent as a single character. Characters and strings are sent as is. For example:
</p><ul><li>Serial.print(78) gives "78"
</li><li>Serial.print(1.23456) gives "1.23"
</li><li>Serial.print('N') gives "N"
</li><li>Serial.print("Hello world.") gives "Hello world."
</li></ul><p class='vspace'></p><p>An optional second parameter specifies the base (format) to use; permitted values are BIN (binary, or base 2), OCT (octal, or base 8), DEC (decimal, or base 10), HEX (hexadecimal, or base 16). For floating point numbers, this parameter specifies the number of decimal places to use. For example:
</p><ul><li>Serial.print(78, BIN) gives "1001110"
</li><li>Serial.print(78, OCT) gives "116"
</li><li>Serial.print(78, DEC) gives "78"
</li><li>Serial.print(78, HEX) gives "4E"
</li><li>Serial.println(1.23456, 0) gives "1"
</li><li>Serial.println(1.23456, 2) gives "1.23"
</li><li>Serial.println(1.23456, 4) gives "1.2346"
</li></ul><p class='vspace'></p><p>You can pass flash-memory based strings to Serial.print() by wrapping them with F(). For example :
</p><ul><li>Serial.print(F(“Hello World”))
</li></ul><p class='vspace'></p><p>To send a single byte, use <a class='wikilink' href='Serial_Write.html'>Serial.write</a>().
</p>
<p class='vspace'></p><h4>Syntax</h4>
<p>Serial.print(val) <br />Serial.print(val, format)
</p>
<p class='vspace'></p><h4>Parameters</h4>
<p>val: the value to print - any data type
</p>
<p class='vspace'></p><p>format: specifies the number base (for integral data types) or number of decimal places (for floating point types)
</p>
<p class='vspace'></p><h4>Returns</h4>
<p>size_t (long): print() returns the number of bytes written, though reading that number is optional
</p>
<p class='vspace'></p><h4>Example:</h4>
<p>
<div class='sourceblock ' id='sourceblock1'>
<div class='sourceblocktext'><div class="arduino"><span class="coMULTI">/*<br />
Uses a FOR loop for data and prints a number in various formats.<br />
*/</span><br />
<span class="kw1">int</span> x <span class="sy0">=</span> <span class="nu0">0</span><span class="sy0">;</span> <span class="co1">// variable</span><br />
<br />
<span class="kw1">void</span> <span class="kw3">setup</span><span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span><br />
<span class="kw1">Serial</span>.<span class="kw1">begin</span><span class="br0">(</span><span class="nu0">9600</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// open the serial port at 9600 bps: </span><br />
<span class="br0">}</span><br />
<br />
<span class="kw1">void</span> <span class="kw3">loop</span><span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span> <br />
<span class="co1">// print labels </span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"NO FORMAT"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a label</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a tab</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"DEC"</span><span class="br0">)</span><span class="sy0">;</span> <br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"HEX"</span><span class="br0">)</span><span class="sy0">;</span> <br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"OCT"</span><span class="br0">)</span><span class="sy0">;</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"BIN"</span><span class="br0">)</span><span class="sy0">;</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <br />
<br />
<span class="kw1">for</span><span class="br0">(</span>x<span class="sy0">=</span><span class="nu0">0</span><span class="sy0">;</span> x<span class="sy0"><</span> <span class="nu0">64</span><span class="sy0">;</span> x<span class="sy0">++</span><span class="br0">)</span><span class="br0">{</span> <span class="co1">// only part of the ASCII chart, change to suit</span><br />
<br />
<span class="co1">// print it out in many formats:</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span>x<span class="br0">)</span><span class="sy0">;</span> <span class="co1">// print as an ASCII-encoded decimal - same as "DEC"</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a tab</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span>x<span class="sy0">,</span> <span class="kw2">DEC</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// print as an ASCII-encoded decimal</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a tab</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span>x<span class="sy0">,</span> <span class="kw2">HEX</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// print as an ASCII-encoded hexadecimal</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a tab</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span>x<span class="sy0">,</span> <span class="kw2">OCT</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// print as an ASCII-encoded octal</span><br />
<span class="kw1">Serial</span>.<span class="kw1">print</span><span class="br0">(</span><span class="st0">"<span class="es1">\t</span>"</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints a tab</span><br />
<br />
<span class="kw1">Serial</span>.<span class="kw1">println</span><span class="br0">(</span>x<span class="sy0">,</span> <span class="kw2">BIN</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// print as an ASCII-encoded binary</span><br />
<span class="co1">// then adds the carriage return with "println"</span><br />
<span class="kw1">delay</span><span class="br0">(</span><span class="nu0">200</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// delay 200 milliseconds</span><br />
<span class="br0">}</span><br />
<span class="kw1">Serial</span>.<span class="kw1">println</span><span class="br0">(</span><span class="st0">""</span><span class="br0">)</span><span class="sy0">;</span> <span class="co1">// prints another carriage return</span><br />
<span class="br0">}</span></div></div>
<div class='sourceblocklink'><a href='Serial_Print?action=sourceblock&num=1.html' type='text/plain'>[Get Code]</a></div>
</div>
</p>
<p class='vspace'></p><h4>Programming Tips </h4>
<p>As of version 1.0, serial transmission is asynchronous; Serial.print() will return before any characters are transmitted.
</p>
<p class='vspace'></p><h4>See also</h4>
<ul><li><a class='wikilink' href='Serial_Begin.html'>begin</a>()
</li><li><a class='wikilink' href='Serial_End.html'>end</a>()
</li><li><a class='wikilink' href='Serial_Available.html'>available</a>()
</li><li><a class='wikilink' href='Serial_Read.html'>read</a>()
</li><li><a class='wikilink' href='Serial_Peek.html'>peek</a>()
</li><li><a class='wikilink' href='Serial_ParseInt.html'>parseInt</a>()
</li><li><a class='wikilink' href='Serial_Flush.html'>flush</a>()
</li><li><a class='selflink' href='Serial_Print.html'>print</a>()
</li><li><a class='wikilink' href='Serial_Println.html'>println</a>()
</li><li><a class='wikilink' href='Serial_Write.html'>write</a>()
</li><li><a class='wikilink' href='SerialEvent.html'>SerialEvent</a>()<br />
</li><li><a class='wikilink' href='http://arduino.cc/en/Tutorial/Memory'>Memory</a>
</li></ul><p class='vspace'></p><p><a class='wikilink' href='index.html'>Reference Home</a>
</p>
</div>
</div>
<!--PageFooterFmt-->
<div id="pagefooter">
©Arduino |
<a href='Serial_Print?action=edit.html'>Edit Page</a> | <a href='Serial_Print?action=diff.html'>Page History</a> | <a href='Serial_Print?action=print.html' target='_blank'>Printable View</a> | <a href='http://arduino.cc/en/Site/AllRecentChanges'>All Recent Site Changes</a>
</div>
<!--/PageFooterFmt-->
</div>
</body>
</html>
