GY-63_MS5611/libraries/DEVFULL/README.md
2022-07-02 12:50:15 +02:00

2.1 KiB

Arduino CI Arduino-lint JSON check License: MIT GitHub release

DEVFULL

Arduino library for a /dev/full stream.

Description

The experimental library implements a stream class that mimics the /dev/full device of a Linux system. You can write nothing to it as it is always full. Every read data will return the value zero, just like /dev/zero.

Calls to print() and println() will be split up in multiple calls to write(). This causes a return value of n x -28 ==> mostly a number in the 65xxx range

See - https://en.wikipedia.org/wiki//dev/full

Versions

  • 0.1.0 is a minimal implementation.
  • 0.1.1 implements INT_MAX

Interface

  • DEVFULL() constructor, sets the timeout to zero.
  • int available() always return INT_MAX = platform dependant.
  • int peek() always returns 0.
  • int read() always returns 0.
  • void flush() does nothing but keeps some compilers happy.
  • size_t write(const uint8_t data) always returns -28 (ENOSPC).
  • size_t write(const uint8_t *buffer, size_t size) implements print interface. Always returns -28 (ENOSPC).

Error code

value name description
-28 ENOSPC No space available for writing onto the "storage device".

Operation

Use with care.

See examples.

Future

  • improve documentation
  • improve code
    • test different platforms.