buffer

This source's internal buffer. It contains data fetched from the downstream, but not yet consumed by the upstream.

Incorrect use of the buffer may cause data loss or unexpected data being read by the upstream. Consider using alternative APIs to read data from the source, if possible:

• use peek for lookahead into a source;

• implement RawSource and wrap a downstream source into it to intercept data being read.