On Tue, 20 Feb 2024 14:23:35 GMT, Alan Bateman <al...@openjdk.org> wrote:
> > Should these methods specify return values when the number of processed > > bytes exceed Integer.MAX_VALUE? > > I think they should, otherwise it's not clear if the return value is clamped > at Integer.MAX_VALUE. The wording can make it clear that the return value is > useless in cases where the total exceeds Integer.MAX_VALUE. Alan, Finding a good way to express this while being correct and succinct was surprisingly hard. What I have now is probably far from perfect, but at least something to serve as a starting point for review: <img width="711" alt="image" src="https://github.com/openjdk/jdk/assets/300291/f258a7f2-c619-44d0-8b2a-78cf3b78aa25"> ------------- PR Comment: https://git.openjdk.org/jdk/pull/17919#issuecomment-1959521558