[jira] Resolved: (IO-223) IOUtils.copy Javadoc inconsistency (return -1 vs. throw ArithmeticException)

["Sebb (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/IO-223?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Sebb resolved IO-223.
---------------------

    Resolution: Fixed

URL: http://svn.apache.org/viewvc?rev=896739&view=rev
Log:
IO-223 IOUtils.copy Javadoc inconsistency (return -1 vs. throw ArithmeticException)


> IOUtils.copy Javadoc inconsistency (return -1 vs. throw ArithmeticException)
> ----------------------------------------------------------------------------
>
>                 Key: IO-223
>                 URL: https://issues.apache.org/jira/browse/IO-223
>             Project: Commons IO
>          Issue Type: Bug
>          Components: Utilities
>    Affects Versions: 1.3, 1.3.1, 1.3.2, 1.4
>            Reporter: Adam Michalik
>
> The javadoc for IOUtils.copy says:
> "Large streams (over 2GB) will return a bytes copied value of -1 after the copy has completed since the correct number of bytes cannot be returned as an int."
> but then it says:
> "Throws:
> ArithmeticException - if the byte count is too large"
> This is an inconsistency since -1 is always returned if the byte count is too large. ArithmeticException is never actually thrown.
> See IO-84 for discussion on solving the "too large byte count" problem.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.