Package com.oracle.truffle.api.strings

Enum Class TruffleString.CodeRange

java.lang.Object

java.lang.Enum<TruffleString.CodeRange>

com.oracle.truffle.api.strings.TruffleString.CodeRange

All Implemented Interfaces:

Serializable, Comparable<TruffleString.CodeRange>, Constable

Enclosing class:

TruffleString

public static enum TruffleString.CodeRange
extends Enum<TruffleString.CodeRange>

Provides information about a string's content. All values of this enum describe a set of codepoints potentially contained by a string reporting said value.

Since:

22.1

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ASCII	All codepoints in this string are part of the Basic Latin Unicode block, also known as ASCII (0x00 - 0x7f).
BMP	All codepoints in this string are part of the Unicode Basic Multilingual Plane (BMP) ( 0x0000 - 0xffff).
BROKEN	If this code range is precise, the string is not encoded correctly (TruffleString.IsValidNode returns false), and contains at least one invalid codepoint.
LATIN_1	All codepoints in this string are part of the ISO-8859-1 character set (0x00 - 0xff), which is equivalent to the union of the Basic Latin and the Latin-1 Supplement Unicode block.
VALID	This string is encoded correctly (TruffleString.IsValidNode returns true), and if this code range is precise, at least one codepoint is outside the largest other applicable code range (e.g.

Method Summary

Modifier and Type	Method	Description
boolean	isSubsetOf(TruffleString.CodeRange other)	Returns true if this set of potential codepoints is equal to or contained by other.
boolean	isSupersetOf(TruffleString.CodeRange other)	Returns true if this set of potential codepoints is equal to or contains other.
static TruffleString.CodeRange	valueOf(String name)	Returns the enum constant of this class with the specified name.
static TruffleString.CodeRange[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

ASCII

public static final TruffleString.CodeRange ASCII

All codepoints in this string are part of the Basic Latin Unicode block, also known as ASCII (0x00 - 0x7f).

Since:

22.1

LATIN_1

public static final TruffleString.CodeRange LATIN_1

All codepoints in this string are part of the ISO-8859-1 character set (0x00 - 0xff), which is equivalent to the union of the Basic Latin and the Latin-1 Supplement Unicode block. If this code range is precise, at least one codepoint is outside the ASCII range (greater than 0x7f). Applicable to TruffleString.Encoding.ISO_8859_1, TruffleString.Encoding.UTF_16 and TruffleString.Encoding.UTF_32 only.

Since:

22.1

BMP

public static final TruffleString.CodeRange BMP

All codepoints in this string are part of the Unicode Basic Multilingual Plane (BMP) ( 0x0000 - 0xffff). If this code range is precise, at least one codepoint is outside the LATIN_1 range (greater than 0xff). Applicable to TruffleString.Encoding.UTF_16 and TruffleString.Encoding.UTF_32 only.

Since:

22.1

VALID

public static final TruffleString.CodeRange VALID

This string is encoded correctly (TruffleString.IsValidNode returns true), and if this code range is precise, at least one codepoint is outside the largest other applicable code range (e.g. greater than 0x7f on TruffleString.Encoding.UTF_8, greater than 0xffff on TruffleString.Encoding.UTF_16).

Since:

22.1

BROKEN

public static final TruffleString.CodeRange BROKEN

If this code range is precise, the string is not encoded correctly (TruffleString.IsValidNode returns false), and contains at least one invalid codepoint. Otherwise, no information about the string is known.

Since:

22.1

Method Details

values

public static TruffleString.CodeRange[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static TruffleString.CodeRange valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

isSubsetOf

public boolean isSubsetOf(TruffleString.CodeRange other)

Returns true if this set of potential codepoints is equal to or contained by other.

Since:

22.1

isSupersetOf

public boolean isSupersetOf(TruffleString.CodeRange other)

Returns true if this set of potential codepoints is equal to or contains other.

Since:

22.1