Package org.jf.util

Class Utf8Utils

java.lang.Object

org.jf.util.Utf8Utils

public final class Utf8Utils
extends Object

Constants of type CONSTANT_Utf8_info.

Field Summary

Fields

Modifier and Type	Field	Description
private static final ThreadLocal<char[]>	localBuffer

Constructor Summary

Constructors

Constructor	Description
Utf8Utils()

Method Summary

Modifier and Type	Method	Description
static byte[]	stringToUtf8Bytes(String string)	Converts a string into its Java-style UTF-8 form.
private static String	throwBadUtf8(int value, int offset)	Helper for utf8BytesToString(byte[], int, int), which throws the right exception for a bogus utf-8 byte.
static String	utf8BytesToString(byte[] bytes, int start, int length)	Converts an array of UTF-8 bytes into a string.
static String	utf8BytesWithUtf16LengthToString(byte[] bytes, int start, int utf16Length)	Converts an array of UTF-8 bytes into a string.
static String	utf8BytesWithUtf16LengthToString(byte[] bytes, int start, int utf16Length, int[] readLength)	Converts an array of UTF-8 bytes into a string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

localBuffer

private static final ThreadLocal<char[]> localBuffer

Constructor Details

Utf8Utils

public Utf8Utils()

Method Details

stringToUtf8Bytes

public static byte[] stringToUtf8Bytes(String string)

Converts a string into its Java-style UTF-8 form. Java-style UTF-8 differs from normal UTF-8 in the handling of character '\0' and surrogate pairs.

Parameters:

string - non-null; the string to convert

Returns:

non-null; the UTF-8 bytes for it

utf8BytesToString

public static String utf8BytesToString(byte[] bytes,
 int start,
 int length)

Converts an array of UTF-8 bytes into a string.

Parameters:

bytes - non-null; the bytes to convert

start - the start index of the utf8 string to convert

length - the length of the utf8 string to convert, not including any null-terminator that might be present

Returns:

non-null; the converted string

utf8BytesWithUtf16LengthToString

public static String utf8BytesWithUtf16LengthToString(@Nonnull
 byte[] bytes,
 int start,
 int utf16Length)

Converts an array of UTF-8 bytes into a string.

Parameters:

bytes - non-null; the bytes to convert

start - the start index of the utf8 string to convert

utf16Length - the number of utf16 characters in the string to decode

Returns:

non-null; the converted string

utf8BytesWithUtf16LengthToString

public static String utf8BytesWithUtf16LengthToString(@Nonnull
 byte[] bytes,
 int start,
 int utf16Length,
 @Nullable
 int[] readLength)

Converts an array of UTF-8 bytes into a string.

Parameters:

bytes - non-null; the bytes to convert

start - the start index of the utf8 string to convert

utf16Length - the number of utf16 characters in the string to decode

readLength - If non-null, the first element will contain the number of bytes read after the method exits

Returns:

non-null; the converted string

throwBadUtf8

private static String throwBadUtf8(int value,
 int offset)

Helper for utf8BytesToString(byte[], int, int), which throws the right exception for a bogus utf-8 byte.

Parameters:

value - the byte value

offset - the file offset

Returns:

never

Throws:

IllegalArgumentException - always thrown