/* Teensyduino Core Library * http://www.pjrc.com/teensy/ * Copyright (c) 2017 PJRC.COM, LLC. * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * 1. The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * 2. If the Software is incorporated into a build system that allows * selection among a list of target devices, then similar target * devices manufactured by PJRC.COM must be included in the list of * target devices and selectable in the same manner. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #ifndef Print_h #define Print_h #include #include // for size_t - gives sprintf and other stuff to all sketches & libs #include #include "core_id.h" #include "WString.h" #include "Printable.h" #define DEC 10 #define HEX 16 #define OCT 8 #define BIN 2 // BYTE was defined in very old versions of Arduino // maybe this now causes more trouble than it's worth? #ifndef BYTE #define BYTE 0 #endif class __FlashStringHelper; class Print { public: constexpr Print() : write_error(0) {} virtual size_t write(uint8_t b) = 0; size_t write(const char *str) { return write((const uint8_t *)str, strlen(str)); } virtual size_t write(const uint8_t *buffer, size_t size); virtual int availableForWrite(void) { return 0; } virtual void flush() { } size_t write(const char *buffer, size_t size) { return write((const uint8_t *)buffer, size); } size_t print(const String &s); size_t print(char c) { return write((uint8_t)c); } size_t print(const char s[]) { return write(s); } size_t print(const __FlashStringHelper *f) { return write((const char *)f); } size_t print(uint8_t b) { return printNumber(b, 10, 0); } size_t print(int n) { return print((long)n); } size_t print(unsigned int n) { return printNumber(n, 10, 0); } size_t print(long n); size_t print(unsigned long n) { return printNumber(n, 10, 0); } size_t print(unsigned char n, int base) { return printNumber(n, base, 0); } size_t print(int n, int base) { return (base == 10) ? print(n) : printNumber(n, base, 0); } size_t print(unsigned int n, int base) { return printNumber(n, base, 0); } size_t print(long n, int base) { return (base == 10) ? print(n) : printNumber(n, base, 0); } size_t print(unsigned long n, int base) { return printNumber(n, base, 0); } size_t print(double n, int digits = 2) { return printFloat(n, digits); } size_t print(const Printable &obj) { return obj.printTo(*this); } size_t println(void); size_t println(const String &s) { return print(s) + println(); } size_t println(char c) { return print(c) + println(); } size_t println(const char s[]) { return print(s) + println(); } size_t println(const __FlashStringHelper *f) { return print(f) + println(); } size_t println(uint8_t b) { return print(b) + println(); } size_t println(int n) { return print(n) + println(); } size_t println(unsigned int n) { return print(n) + println(); } size_t println(long n) { return print(n) + println(); } size_t println(unsigned long n) { return print(n) + println(); } size_t println(unsigned char n, int base) { return print(n, base) + println(); } size_t println(int n, int base) { return print(n, base) + println(); } size_t println(unsigned int n, int base) { return print(n, base) + println(); } size_t println(long n, int base) { return print(n, base) + println(); } size_t println(unsigned long n, int base) { return print(n, base) + println(); } size_t println(double n, int digits = 2) { return print(n, digits) + println(); } size_t println(const Printable &obj) { return obj.printTo(*this) + println(); } int getWriteError() { return write_error; } void clearWriteError() { setWriteError(0); } int printf(const char *format, ...); int printf(const __FlashStringHelper *format, ...); protected: void setWriteError(int err = 1) { write_error = err; } private: char write_error; size_t printFloat(double n, uint8_t digits); #ifdef __MKL26Z64__ size_t printNumberDec(unsigned long n, uint8_t sign); size_t printNumberHex(unsigned long n); size_t printNumberBin(unsigned long n); size_t printNumberAny(unsigned long n, uint8_t base); inline size_t printNumber(unsigned long n, uint8_t base, uint8_t sign) __attribute__((always_inline)) { // when "base" is a constant (pretty much always), the // compiler optimizes this to a single function call. if (base == 0) return write((uint8_t)n); if (base == 10 || base < 2) return printNumberDec(n, sign); if (base == 16) return printNumberHex(n); if (base == 2) return printNumberBin(n); return printNumberAny(n, base); } #else size_t printNumber(unsigned long n, uint8_t base, uint8_t sign); #endif }; #endif