com.starteam.util
Class UTF8

java.lang.Object
  com.starteam.util.UTF8

public final class UTF8
extends java.lang.Object

Implements UTF-8 conversion routines as described by RFC-2279

Method Summary

static byte[]	StringToUtf8(java.lang.String src) Converts a string to an array of UTF-8 characters.
static int	Utf16ToUtf8(char[] src, byte[] dst) Converts an array of characters in UTF-16/Unicode format to an array of characters in UTF-8 characters.
static java.lang.String	Utf8ToString(byte[] src) Converts an array of characters in UTF-8 format to a Unicode string.
static int	Utf8ToUtf16(byte[] src, char[] dst) Converts an array of characters in UTF-8 format to an array of UTF-16/Unicode characters.
static int	Utf8ToUtf16Char(java.io.InputStream src) Returns a single UTF-16 character by reading as many characters as necessary from a given InputStream, which is a stream of UTF-8 bytes.

Methods inherited from class java.lang.Object

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

Method Detail

Utf8ToString

public static java.lang.String Utf8ToString(byte[] src)

Converts an array of characters in UTF-8 format to a Unicode string.

Parameters:

src - Source string, in UTF-8 format.

Returns:

The translated string.

Utf8ToUtf16Char

public static int Utf8ToUtf16Char(java.io.InputStream src)

Returns a single UTF-16 character by reading as many characters as necessary from a given InputStream, which is a stream of UTF-8 bytes.

Parameters:

src - Source stream, in UTF-8 format.

Returns:

The next character constructed from the stream, -1 if no more.

Utf8ToUtf16

public static int Utf8ToUtf16(byte[] src,
                              char[] dst)

Converts an array of characters in UTF-8 format to an array of UTF-16/Unicode characters.

Parameters:

src - Source string, in UTF-8 format.

dst - Output buffer for unicode characters.

Returns:

The number of characters written. If dst is null, then only returns the number of chars needed.

StringToUtf8

public static byte[] StringToUtf8(java.lang.String src)

Converts a string to an array of UTF-8 characters.

Parameters:

src - Source string.

Returns:

The translated array of characters in UTF-8 format.

Utf16ToUtf8

public static int Utf16ToUtf8(char[] src,
                              byte[] dst)

Converts an array of characters in UTF-16/Unicode format to an array of characters in UTF-8 characters.

Parameters:

src - Source string, in unicode format.

dst - Output buffer for utf-8 characters.

Returns:

The number of bytes written. If dst is null, then only returns the number of bytes needed.