Add a note about malformed-input and unmappable-character sequences

This commit is contained in:
Liam Miller-Cushon 2026-01-19 23:01:14 +01:00
parent fd989e87da
commit 08929964be

View File

@ -2106,6 +2106,9 @@ public final class String
/**
* {@return the length in bytes of the given String encoded with the given {@link Charset}}
*
* <p>The returned length accounts for the replacement of malformed-input and unmappable-character
* sequences with the charset's default replacement byte array.
*
* <p>The result will be the same value as {@link #getBytes(Charset) getBytes(cs).length}.
*
* @apiNote This method provides equivalent or better performance than {@link #getBytes(Charset)