On Wed, 20 Oct 2021 18:56:22 GMT, Naoto Sato <[email protected]> wrote:
>> src/java.base/share/classes/java/nio/charset/Charset.java line 545:
>>
>>> 543: * @return A charset object for the named charset, or {@code
>>> fallback}
>>> 544: * in case the charset object for the named charset is not
>>> 545: * available. May be {@code null}
>>
>> A minor comment: it seems to me returning the fallback charset is
>> sufficient, and "May be null" may be not necessary since the fallback
>> charset is provided, it's expected if it's null.
>
> Thanks, Joe. Moved that explanation into the `fallback` param, which I
> initially intended.
The java.nio.charset package has the usual "Unless otherwise noted, passing a
null argument ..." so if fallback is allowed to be null then you will need to
add ", can null" to its description.
-------------
PR: https://git.openjdk.java.net/jdk/pull/6045