javadoc for CharsetEncoder.maxBytesPerChar() should be made clearer

XMLWordPrintable

    • Type: Enhancement
    • Resolution: Won't Fix
    • Priority: P5
    • None
    • Affects Version/s: 9
    • Component/s: core-libs
    • None

      Javadoc currently states:

      --------------------------------
      public final float CharsetEncoder.maxBytesPerChar()
      Returns the maximum number of bytes that will be produced for each character of input.
      This value may be used to compute the worst-case size of the output buffer required for a given input sequence.
      --------------------------------

      This may be misinterpreted, as it may be not clear what CHARACTERs this sentence is about.
      If they were Unicode code-points, UTF8Encoder.maxBytesPerChar() should return 4.0.
      However, as the statement is in fact about Java characters, it correctly returns 3.0.

            Assignee:
            Naoto Sato
            Reporter:
            Ivan Gerasimov
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: