.. | ||
.github | ||
examples | ||
test | ||
.arduino-ci.yml | ||
CHANGELOG.md | ||
keywords.txt | ||
library.json | ||
library.properties | ||
LICENSE | ||
PrintSize.h | ||
readme.md |
PrintSize
Arduino library to determine the length of print statements.
Description
PrintSize is a minimal library to determine the length of a variable when printed. This includes printing of floats, integers in decimal or hex notation.
Works for print(), println() and if supported printf() e.g. ESP32.
Since 0.2.0 it has a total counter to add up the characters "printed" since the last reset() call. See examples.
Related
- https://github.com/RobTillaart/PrintCharArray captures data in a char array buffer.
- https://github.com/RobTillaart/PrintSize counts length of a number of print commands.
- https://github.com/RobTillaart/PrintString captures data in a String.
Interface
#include "PrintSize.h"
- PrintSize() Constructor
- size_t write(uint8_t c) core. Note: gives a warning unused parameter.
- size_t write(uint8_t * str, uint8_t length) Note: gives a warning unused parameter.
- void reset() reset the total counter.
- uint32_t total() total bytes "printed".
Operational
Example PrintSize1.ino shows the right alignment of 10 random numbers.
Example PrintSize_total.ino shows (elementary) line fitting.
Applications
Can be used to calculate the needed space.
- to properly do a right alignment e.g. for numbers or variable text.
- do left alignment and overwrite previous output with just enough spaces.
- centring of numbers.
- see if output will fit into a line / display.
- see if a string fits in EEPROM or any other storage medium.
- see if a string fits in a communication buffer.
Future
Must
Should
- add examples
- add a function to handle tab char correctly e.g.
could add more than one char. Interferes with the write(str, length).
- setTabSize(2, 4, 6, 8...);
- getTabSize();
- uint8_t _tabSize = 4;
Could
- PRINTSIZE_LIB_VERSION ?
Wont
Support
If you appreciate my libraries, you can support the development and maintenance. Improve the quality of the libraries by providing issues and Pull Requests, or donate through PayPal or GitHub sponsors.
Thank you,