2 Print.cpp - Base class that provides print() and println()
3 Copyright (c) 2008 David A. Mellis. All right reserved.
5 This library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 This library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with this library; if not, write to the Free Software
17 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 Modified 23 November 2006 by David A. Mellis
20 Modified 03 August 2015 by Chuck Todd
31 // Public Methods //////////////////////////////////////////////////////////////
33 /* default implementation: may be overridden */
34 size_t Print::write(const uint8_t *buffer, size_t size)
38 if (write(*buffer++)) n++;
44 size_t Print::print(const __FlashStringHelper *ifsh)
46 PGM_P p = reinterpret_cast<PGM_P>(ifsh);
49 unsigned char c = pgm_read_byte(p++);
57 size_t Print::print(const String &s)
59 return write(s.c_str(), s.length());
62 size_t Print::print(const char str[])
67 size_t Print::print(char c)
72 size_t Print::print(unsigned char b, int base)
74 return print((unsigned long) b, base);
77 size_t Print::print(int n, int base)
79 return print((long) n, base);
82 size_t Print::print(unsigned int n, int base)
84 return print((unsigned long) n, base);
87 size_t Print::print(long n, int base)
91 } else if (base == 10) {
95 return printNumber(n, 10) + t;
97 return printNumber(n, 10);
99 return printNumber(n, base);
103 size_t Print::print(unsigned long n, int base)
105 if (base == 0) return write(n);
106 else return printNumber(n, base);
109 size_t Print::print(double n, int digits)
111 return printFloat(n, digits);
114 size_t Print::println(const __FlashStringHelper *ifsh)
116 size_t n = print(ifsh);
121 size_t Print::print(const Printable& x)
123 return x.printTo(*this);
126 size_t Print::println(void)
128 return write("\r\n");
131 size_t Print::println(const String &s)
138 size_t Print::println(const char c[])
145 size_t Print::println(char c)
152 size_t Print::println(unsigned char b, int base)
154 size_t n = print(b, base);
159 size_t Print::println(int num, int base)
161 size_t n = print(num, base);
166 size_t Print::println(unsigned int num, int base)
168 size_t n = print(num, base);
173 size_t Print::println(long num, int base)
175 size_t n = print(num, base);
180 size_t Print::println(unsigned long num, int base)
182 size_t n = print(num, base);
187 size_t Print::println(double num, int digits)
189 size_t n = print(num, digits);
194 size_t Print::println(const Printable& x)
201 // Private Methods /////////////////////////////////////////////////////////////
203 size_t Print::printNumber(unsigned long n, uint8_t base)
205 char buf[8 * sizeof(long) + 1]; // Assumes 8-bit chars plus zero byte.
206 char *str = &buf[sizeof(buf) - 1];
210 // prevent crash if called with base == 1
211 if (base < 2) base = 10;
217 *--str = c < 10 ? c + '0' : c + 'A' - 10;
223 size_t Print::printFloat(double number, uint8_t digits)
227 if (isnan(number)) return print("nan");
228 if (isinf(number)) return print("inf");
229 if (number > 4294967040.0) return print ("ovf"); // constant determined empirically
230 if (number <-4294967040.0) return print ("ovf"); // constant determined empirically
232 // Handle negative numbers
239 // Round correctly so that print(1.999, 2) prints as "2.00"
240 double rounding = 0.5;
241 for (uint8_t i=0; i<digits; ++i)
246 // Extract the integer part of the number and print it
247 unsigned long int_part = (unsigned long)number;
248 double remainder = number - (double)int_part;
249 n += print(int_part);
251 // Print the decimal point, but only if there are digits beyond
256 // Extract digits from the remainder one at a time
260 unsigned int toPrint = (unsigned int)(remainder);
262 remainder -= toPrint;