ArduinoCore-API icon indicating copy to clipboard operation
ArduinoCore-API copied to clipboard

Stream - new virtual method `clear()` to clear the receive buffer

Open JAndrassy opened this issue 1 year ago • 0 comments

A very long time ago, in Arduino, flush() changed from "purge input" to "send output buffer" and moved from Stream to Print. But now there is no method to "purge input" and there is demand as I see it on forums.

Arduino classes and methods are inspired by the Processing language. Processing has Stream.clear().

The goal of this PR is to establish the name clear for "purge input" functions in Stream implementations.

For backward compatibility the method can not be added as pure virtual so some implementation has to be provided. An empty implementation would be confusing, so I took the flush() implementation from Arduino 0023 Ethernet library's Client class.

JAndrassy avatar May 14 '24 08:05 JAndrassy