The index one greater than the last valid character in the input
stream buffer.
This value should always be nonnegative
and not larger than the length of buf
.
It is one greater than the position of
the last byte within buf
that
can ever be read from the input stream buffer.
Diagram: InputStream