Modifier and Type	Class and Description
public static enum	Convert.Validation Modified UTF-8 decoding validation levels.

Access	Constructor and Description
public	Convert()

Method Summary

Modifier and Type	Method and Description
public static int	chars2utf(char[] The array holding the characters to convert. src, int The start index from which characters are converted. sindex, byte[] The array holding the converted characters.. dst, int The start index from which converted bytes are written. dindex, int The maximum number of characters to convert. len) Copy characters in source array to bytes in target array, converting them to Utf8 representation.
public static byte[]	chars2utf(char[] The array holding the characters. src, int The start index from which characters are converted. sindex, int The maximum number of characters to convert. len) Return characters as an array of bytes in Utf8 representation.
public static byte[]	chars2utf(char[] The array holding the characters. src) Return all characters in given array as an array of bytes in Utf8 representation.
public static List<Name>	classCandidates(Name name)
public static List<Name>	enclosingCandidates(Name name)
public static String	escapeUnicode(String s) Escape all unicode characters in string.
private static boolean	isPrintableAscii(char ch) Is a character printable ASCII?
public static Name	packagePart(Name classname) Return the package name of a class name, excluding the trailing '.', "" if not existent.
public static String	packagePart(String classname)
public static String	quote(String s) Escapes each character in a string that has an escape sequence or is non-printable ASCII.
public static String	quote(char ch, boolean charContext) Escapes a character if it has an escape sequence or is non-printable ASCII.
public static Name	Returns: the last part of the qualified name shortName(Name the qualified name name) Return the last part of a qualified name.
public static String	Returns: the last part of the qualified name shortName(String the string representation of the qualified name name) Return the last part of a qualified name from its string representation
public static int	string2int(String s, int radix) Convert string to integer.
public static long	string2long(String s, int radix) Convert string to long integer.
public static byte[]	string2utf(String s) Return string as an array of bytes in in Utf8 representation.
public static int	Returns: the index in `dst` just after the last copied char utf2chars(byte[] The array holding the bytes to convert. src, int The start index from which bytes are converted. soff, char[] The array holding the converted characters, or null to just validate dst, int The start index from which converted characters are written. doff, int The maximum number of bytes to convert. len, Convert.Validation Level of validation validation) Decode characters encoded in Modified UTF-8 encoding using the given validation level.
public static char[]	Returns: The decoded characters in an array. utf2chars(byte[] The array holding the bytes. src, int The start index from which bytes are converted. sindex, int The maximum number of bytes to convert. len, Convert.Validation Level of validation validation) Decode characters encoded in Modified UTF-8 encoding.
public static String	utf2string(byte[] The array holding the bytes. src, int The start index from which bytes are converted. sindex, int The maximum number of bytes to convert. len, Convert.Validation Level of validation validation) Decode a `String` encoded in Modified UTF-8 encoding.
public static int	Returns: the number of encoded characters utfNumChars(byte[] data buffer buf, int starting offset of UTF-8 data off, int number of bytes of UTF-8 data len) Count the number of characters encoded in a Modified UTF-8 encoding.
public static void	utfValidate(byte[] Buffer containing data buf, int Data starting offset off, int Data length len, Convert.Validation Level of validation validation) Validate the given Modified UTF-8 encoding using the given validation level.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

Convert	back to summary
public Convert()

Method Detail

chars2utf	back to summary
public static int chars2utf(char[] src, int sindex, byte[] dst, int dindex, int len) Copy characters in source array to bytes in target array, converting them to Utf8 representation. The target array must be large enough to hold the result. returns first index in `dst' past the last copied byte. Parameters src:char[] The array holding the characters to convert. sindex:int The start index from which characters are converted. dst:byte[] The array holding the converted characters.. dindex:int The start index from which converted bytes are written. len:int The maximum number of characters to convert.

chars2utf

back to summary

public static int chars2utf(char[] src, int sindex, byte[] dst, int dindex, int len)

Copy characters in source array to bytes in target array, converting them to Utf8 representation. The target array must be large enough to hold the result. returns first index in `dst' past the last copied byte.

Parameters

src:char[]: The array holding the characters to convert.
sindex:int: The start index from which characters are converted.
dst:byte[]: The array holding the converted characters..
dindex:int: The start index from which converted bytes are written.
len:int: The maximum number of characters to convert.

chars2utf	back to summary
public static byte[] chars2utf(char[] src, int sindex, int len) Return characters as an array of bytes in Utf8 representation. Parameters src:char[] The array holding the characters. sindex:int The start index from which characters are converted. len:int The maximum number of characters to convert.

chars2utf

back to summary

public static byte[] chars2utf(char[] src, int sindex, int len)

Return characters as an array of bytes in Utf8 representation.

Parameters

src:char[]: The array holding the characters.
sindex:int: The start index from which characters are converted.
len:int: The maximum number of characters to convert.

chars2utf	back to summary
public static byte[] chars2utf(char[] src) Return all characters in given array as an array of bytes in Utf8 representation. Parameters src:char[] The array holding the characters.

chars2utf

back to summary

public static byte[] chars2utf(char[] src)

Return all characters in given array as an array of bytes in Utf8 representation.

Parameters

src:char[]: The array holding the characters.

classCandidates	back to summary
public static List<Name> classCandidates(Name name)

enclosingCandidates	back to summary
public static List<Name> enclosingCandidates(Name name)

escapeUnicode	back to summary
public static String escapeUnicode(String s) Escape all unicode characters in string.

isPrintableAscii	back to summary
private static boolean isPrintableAscii(char ch) Is a character printable ASCII?

packagePart	back to summary
public static Name packagePart(Name classname) Return the package name of a class name, excluding the trailing '.', "" if not existent.

packagePart	back to summary
public static String packagePart(String classname)

quote	back to summary
public static String quote(String s) Escapes each character in a string that has an escape sequence or is non-printable ASCII. Leaves non-ASCII characters alone.

quote	back to summary
public static String quote(char ch, boolean charContext) Escapes a character if it has an escape sequence or is non-printable ASCII. Leaves non-ASCII characters alone.

shortName	back to summary
public static Name shortName(Name name) Return the last part of a qualified name. Parameters name:Name the qualified name Returns:Name the last part of the qualified name

shortName

back to summary

public static Name shortName(Name name)

Return the last part of a qualified name.

Parameters

name:Name: the qualified name

Returns:Name

the last part of the qualified name

shortName	back to summary
public static String shortName(String name) Return the last part of a qualified name from its string representation Parameters name:String the string representation of the qualified name Returns:String the last part of the qualified name

shortName

back to summary

public static String shortName(String name)

Return the last part of a qualified name from its string representation

Parameters

name:String: the string representation of the qualified name

Returns:String

the last part of the qualified name

string2int	back to summary
public static int string2int(String s, int radix) throws NumberFormatException Convert string to integer.

string2long	back to summary
public static long string2long(String s, int radix) throws NumberFormatException Convert string to long integer.

string2utf	back to summary
public static byte[] string2utf(String s) Return string as an array of bytes in in Utf8 representation.

utf2chars back to summary

utf2chars	back to summary
public static int utf2chars(byte[] src, int soff, char[] dst, int doff, int len, Convert.Validation validation) throws InvalidUtfException Decode characters encoded in Modified UTF-8 encoding using the given validation level. Reject any invalid data by throwing an `InvalidUtfException`. Parameters are as in System.arraycopy(): Parameters src:byte[] The array holding the bytes to convert. soff:int The start index from which bytes are converted. dst:char[] The array holding the converted characters, or null to just validate doff:int The start index from which converted characters are written. len:int The maximum number of bytes to convert. validation:Convert.Validation Level of validation Returns:int the index in `dst` just after the last copied char Exceptions InvalidUtfException: if invalid Modified UTF-8 is encountered if `validation` is not `Validation#NONE` and invalid Modified UTF-8 is encountered

public static int utf2chars(byte[] src, int soff, char[] dst, int doff, int len, Convert.Validation validation) throws InvalidUtfException

Decode characters encoded in Modified UTF-8 encoding using the given validation level. Reject any invalid data by throwing an InvalidUtfException. Parameters are as in System.arraycopy():

Parameters

src:byte[]: The array holding the bytes to convert.
soff:int: The start index from which bytes are converted.
dst:char[]: The array holding the converted characters, or null to just validate
doff:int: The start index from which converted characters are written.
len:int: The maximum number of bytes to convert.
validation:Convert.Validation: Level of validation

Returns:int

the index in dst just after the last copied char

Exceptions

InvalidUtfException:

if invalid Modified UTF-8 is encountered
if validation is not Validation#NONE and invalid Modified UTF-8 is encountered

utf2chars back to summary

utf2chars	back to summary
public static char[] utf2chars(byte[] src, int sindex, int len, Convert.Validation validation) throws InvalidUtfException Decode characters encoded in Modified UTF-8 encoding. Parameters src:byte[] The array holding the bytes. sindex:int The start index from which bytes are converted. len:int The maximum number of bytes to convert. validation:Convert.Validation Level of validation Returns:char[] The decoded characters in an array. Exceptions InvalidUtfException: if `validation` is not `Validation#NONE` and invalid Modified UTF-8 is encountered

public static char[] utf2chars(byte[] src, int sindex, int len, Convert.Validation validation) throws InvalidUtfException

Decode characters encoded in Modified UTF-8 encoding.

Parameters

src:byte[]: The array holding the bytes.
sindex:int: The start index from which bytes are converted.
len:int: The maximum number of bytes to convert.
validation:Convert.Validation: Level of validation

Returns:char[]

The decoded characters in an array.

Exceptions

InvalidUtfException:: if validation is not Validation#NONE and invalid Modified UTF-8 is encountered

utf2string back to summary

utf2string	back to summary
public static String utf2string(byte[] src, int sindex, int len, Convert.Validation validation) throws InvalidUtfException Decode a `String` encoded in Modified UTF-8 encoding. Parameters src:byte[] The array holding the bytes. sindex:int The start index from which bytes are converted. len:int The maximum number of bytes to convert. validation:Convert.Validation Level of validation Exceptions InvalidUtfException: if `validation` is not `Validation#NONE` and invalid Modified UTF-8 is encountered

public static String utf2string(byte[] src, int sindex, int len, Convert.Validation validation) throws InvalidUtfException

Decode a String encoded in Modified UTF-8 encoding.

Parameters

src:byte[]: The array holding the bytes.
sindex:int: The start index from which bytes are converted.
len:int: The maximum number of bytes to convert.
validation:Convert.Validation: Level of validation

Exceptions

InvalidUtfException:: if validation is not Validation#NONE and invalid Modified UTF-8 is encountered

utfNumChars	back to summary
public static int utfNumChars(byte[] buf, int off, int len) Count the number of characters encoded in a Modified UTF-8 encoding. This method does not check for invalid data. Parameters buf:byte[] data buffer off:int starting offset of UTF-8 data len:int number of bytes of UTF-8 data Returns:int the number of encoded characters

utfNumChars

back to summary

public static int utfNumChars(byte[] buf, int off, int len)

Count the number of characters encoded in a Modified UTF-8 encoding. This method does not check for invalid data.

Parameters

buf:byte[]: data buffer
off:int: starting offset of UTF-8 data
len:int: number of bytes of UTF-8 data

Returns:int

the number of encoded characters

utfValidate back to summary

utfValidate	back to summary
public static void utfValidate(byte[] buf, int off, int len, Convert.Validation validation) throws InvalidUtfException Validate the given Modified UTF-8 encoding using the given validation level. Reject invalid data by throwing an `InvalidUtfException`. Note there is no point in calling this method with `Validation#NONE`. Parameters buf:byte[] Buffer containing data off:int Data starting offset len:int Data length validation:Convert.Validation Level of validation Exceptions InvalidUtfException: if `validation` is not `Validation#NONE` and invalid Modified UTF-8 is encountered

public static void utfValidate(byte[] buf, int off, int len, Convert.Validation validation) throws InvalidUtfException

Validate the given Modified UTF-8 encoding using the given validation level. Reject invalid data by throwing an InvalidUtfException.

Note

there is no point in calling this method with Validation#NONE.

Parameters

buf:byte[]: Buffer containing data
off:int: Data starting offset
len:int: Data length
validation:Convert.Validation: Level of validation

Exceptions

InvalidUtfException:: if validation is not Validation#NONE and invalid Modified UTF-8 is encountered

com.sun.tools.javac.util back to summary

public final Enum Convert.Validation

Class Inheritance

extends Enum<Convert.Validation>

java.lang.Object
java.lang.Enum
com.sun.tools.javac.util.Convert.Validation

Modified UTF-8 decoding validation levels.

Field Summary

Modifier and Type	Field and Description
private final boolean	allowAnything
private final boolean	allowLongEncoding
private final boolean	allowSingleByteNul
public static final Convert.Validation	NONE Do zero validation of UTF-8, i.e., always decode something without error.
public static final Convert.Validation	PREJDK14 Do validation in accordance with the pre-JDK 1.4 Java class file format, which allows (a) the NUL character `\u0000` to be encoded as a single byte and (b) longer-than-necessary encodings (e.g., three bytes instead of two).
public static final Convert.Validation	STRICT Do strict validation.

Constructor Summary

Access	Constructor and Description
private	Validation(boolean allowSingleByteNul, boolean allowLongEncoding, boolean allowAnything)

Method Summary

Modifier and Type	Method and Description
public boolean	allowAnything() Whether to allow anything, including truncated characters and bogus flag bits.
public boolean	allowLongEncoding() Whether to allow characters to be encoded using more bytes than required.
public boolean	allowSingleByteNul() Whether to allow the NUL character `\u0000` to be encoded as a single byte.
public static Convert.Validation	valueOf(String name)
public static Convert.Validation[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

allowAnything	back to summary
private final boolean allowAnything

allowLongEncoding	back to summary
private final boolean allowLongEncoding

allowSingleByteNul	back to summary
private final boolean allowSingleByteNul

NONE	back to summary
public static final Convert.Validation NONE Do zero validation of UTF-8, i.e., always decode something without error. When this is used, `InvalidUtfException` is never thrown.

PREJDK14	back to summary
public static final Convert.Validation PREJDK14 Do validation in accordance with the pre-JDK 1.4 Java class file format, which allows (a) the NUL character `\u0000` to be encoded as a single byte and (b) longer-than-necessary encodings (e.g., three bytes instead of two).

STRICT	back to summary
public static final Convert.Validation STRICT Do strict validation. At this level, each character has only one valid encoding.

Constructor Detail

Validation	back to summary
private Validation(boolean allowSingleByteNul, boolean allowLongEncoding, boolean allowAnything)

Method Detail

allowAnything	back to summary
public boolean allowAnything() Whether to allow anything, including truncated characters and bogus flag bits.

allowLongEncoding	back to summary
public boolean allowLongEncoding() Whether to allow characters to be encoded using more bytes than required.

allowSingleByteNul	back to summary
public boolean allowSingleByteNul() Whether to allow the NUL character `\u0000` to be encoded as a single byte. Modified UTF-8 specifies that it be encoded in two bytes.

valueOf	back to summary
public static Convert.Validation valueOf(String name)

values	back to summary
public static Convert.Validation[] values()

public Class Convert

Nested and Inner Type Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

public final Enum Convert.Validation

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail