Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8058875

javadoc for CharsetEncoder.maxBytesPerChar() should be made clearer

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Won't Fix
    • Icon: P5 P5
    • tbd
    • 9
    • core-libs

      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.

            Unassigned Unassigned
            shadowbug Shadow Bug
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: