@Beta @GwtCompatible public final class Utf8 extends Object
The variant of UTF-8 implemented by this class is the restricted definition of UTF-8 introduced in Unicode 3.1. One implication of this is that it rejects "non-shortest form" byte sequences, even though the JDK decoder may accept them.
Modifier and Type | Method and Description |
---|---|
static int |
encodedLength(CharSequence
Returns the number of bytes in the UTF-8-encoded form of
sequence .
|
static boolean |
isWellFormed(byte[] bytes)
Returns
true if
bytes is a
well-formed UTF-8 byte sequence according to Unicode 6.0.
|
static boolean |
isWellFormed(byte[] bytes, int off, int len)
Returns whether the given byte array slice is a well-formed UTF-8 byte sequence, as defined by
isWellFormed(byte[]) .
|
public static int encodedLength(CharSequencesequence)
sequence
. For a string, this method is equivalent to
string.getBytes(UTF_8).length
, but is more efficient in both time and space.
IllegalArgumentException
- if
sequence
contains ill-formed UTF-16 (unpaired surrogates)
public static boolean isWellFormed(byte[] bytes)
true
if
bytes
is a
well-formed UTF-8 byte sequence according to Unicode 6.0. Note that this is a stronger criterion than simply whether the bytes can be decoded. For example, some versions of the JDK decoder will accept "non-shortest form" byte sequences, but encoding never reproduces these. Such byte sequences are
not considered well-formed.
This method returns true
if and only if Arrays.equals(bytes, new String(bytes, UTF_8).getBytes(UTF_8))
does, but is more efficient in both time and space.
public static boolean isWellFormed(byte[] bytes, int off, int len)
isWellFormed(byte[])
. Note that this can be false even when
isWellFormed(bytes)
is true.
bytes
- the input buffer
off
- the offset in the buffer of the first byte to read
len
- the number of bytes to read from the buffer