Skip to content

Arduino library to determine the length of print statements

License

Notifications You must be signed in to change notification settings

RobTillaart/PrintSize

Repository files navigation

Arduino CI Arduino-lint JSON check GitHub issues

License: MIT GitHub release PlatformIO Registry

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

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,