[
https://issues.apache.org/jira/browse/LANG-1070?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14229194#comment-14229194
]
Sebb commented on LANG-1070:
----------------------------
I agree it would be OK to return null if both inputs are null.
I think the reason for throwing IAE is that one cannot determine the type if
both arguments are null.
However that does not matter if the return itself is null.
> confusing example in ArrayUtils.add()
> -------------------------------------
>
> Key: LANG-1070
> URL: https://issues.apache.org/jira/browse/LANG-1070
> Project: Commons Lang
> Issue Type: Improvement
> Components: lang.*
> Affects Versions: 3.3.2
> Reporter: Paul Pogonyshev
> Priority: Trivial
>
> Method documentation claims that
> ArrayUtils.add(null, null) = null
> However, this is not true since this parameter combination leads to an
> exception.
> Either remove this line from documentation, or rewrite it to explicitly
> mention the exception. Maybe there are other related methods with similar
> problem in the docs.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)