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

Reply via email to