Package com.oracle.truffle.api.strings

Class AbstractTruffleString

java.lang.Object

com.oracle.truffle.api.strings.AbstractTruffleString

Direct Known Subclasses:

MutableTruffleString, TruffleString

public abstract sealed class AbstractTruffleString
extends Object
permits TruffleString, MutableTruffleString

Abstract base class for Truffle strings. Useful when a value can be both a TruffleString or a MutableTruffleString. Note that values of this type are not valid interop values. They must be converted to TruffleString before passing them to other languages.

Since:

22.1

See Also:

• TruffleString

Method Summary

Modifier and Type	Method	Description
final MutableTruffleString	asManagedMutableTruffleStringUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.AsManagedNode.
final TruffleString	asManagedTruffleStringUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.AsManagedNode.
final TruffleString	asManagedTruffleStringUncached(TruffleString.Encoding expectedEncoding, boolean cacheResult)	Shorthand for calling the uncached version of TruffleString.AsManagedNode.
final MutableTruffleString	asMutableTruffleStringUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of MutableTruffleString.AsMutableTruffleStringNode.
final TruffleString	asTruffleStringUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.FromByteArrayNode.
final int	byteIndexOfAnyByteUncached(int fromByteIndex, int maxByteIndex, byte[] values, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ByteIndexOfAnyByteNode.
final int	byteIndexOfCodePointUncached(int cp, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ByteIndexOfCodePointNode.
final int	byteIndexOfStringUncached(AbstractTruffleString b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ByteIndexOfStringNode.
final int	byteIndexOfStringUncached(TruffleString.WithMask b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ByteIndexOfStringNode.
final int	byteIndexToCodePointIndexUncached(int byteOffset, int byteIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ByteIndexToCodePointIndexNode.
final int	byteLength(TruffleString.Encoding expectedEncoding)	Get this string's length in bytes.
final int	byteLengthOfCodePointUncached(int byteIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.
final int	byteLengthOfCodePointUncached(int byteIndex, TruffleString.Encoding expectedEncoding, TruffleString.ErrorHandling errorHandling)	Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.
final int	charIndexOfAnyCharUTF16Uncached(int fromCharIndex, int maxCharIndex, char[] values)	Shorthand for calling the uncached version of TruffleString.CharIndexOfAnyCharUTF16Node.
final int	codePointAtByteIndexUncached(int i, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CodePointAtByteIndexNode.
final int	codePointAtByteIndexUncached(int i, TruffleString.Encoding expectedEncoding, TruffleString.ErrorHandling errorHandling)	Shorthand for calling the uncached version of TruffleString.CodePointAtByteIndexNode.
final int	codePointAtIndexUncached(int i, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CodePointAtIndexNode.
final int	codePointAtIndexUncached(int i, TruffleString.Encoding expectedEncoding, TruffleString.ErrorHandling errorHandling)	Shorthand for calling the uncached version of TruffleString.CodePointAtIndexNode.
final int	codePointIndexToByteIndexUncached(int byteOffset, int codepointIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.
final int	codePointLengthUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CodePointLengthNode.
final boolean	codeRangeEqualsUncached(TruffleString.CodeRange otherCodeRange)	Shorthand for calling the uncached version of TruffleString.CodeRangeEqualsNode.
final int	compareBytesUncached(AbstractTruffleString b, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CompareBytesNode.
final int	compareCharsUTF16Uncached(AbstractTruffleString b)	Shorthand for calling the uncached version of TruffleString.CompareCharsUTF16Node.
final int	compareIntsUTF32Uncached(AbstractTruffleString b)	Shorthand for calling the uncached version of TruffleString.CompareIntsUTF32Node.
final TruffleString	concatUncached(AbstractTruffleString b, TruffleString.Encoding expectedEncoding, boolean lazy)	Shorthand for calling the uncached version of TruffleString.ConcatNode.
final void	copyToByteArrayNodeUncached(int byteFromIndexA, byte[] dst, int byteFromIndexDst, int byteLength, TruffleString.Encoding expectedEncoding)	Deprecated. since 22.3, use copyToByteArrayUncached(int, byte[], int, int, Encoding) instead.
final void	copyToByteArrayUncached(int byteFromIndexA, byte[] dst, int byteFromIndexDst, int byteLength, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CopyToByteArrayNode.
final byte[]	copyToByteArrayUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CopyToByteArrayNode.
final void	copyToNativeMemoryNodeUncached(int byteFromIndexA, Object pointerObject, int byteFromIndexDst, int byteLength, TruffleString.Encoding expectedEncoding)	Deprecated. since 22.3, use copyToNativeMemoryUncached(int, Object, int, int, Encoding) instead.
final void	copyToNativeMemoryUncached(int byteFromIndexA, Object pointerObject, int byteFromIndexDst, int byteLength, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CopyToNativeMemoryNode.
final TruffleStringIterator	createBackwardCodePointIteratorUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CreateBackwardCodePointIteratorNode.
final TruffleStringIterator	createCodePointIteratorUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.CreateCodePointIteratorNode.
final boolean	equals(Object obj)	Returns true if this string is equal to obj.
final boolean	equalsUncached(AbstractTruffleString b, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.EqualNode.
final TruffleString	forceEncodingUncached(TruffleString.Encoding expectedEncoding, TruffleString.Encoding targetEncoding)	Shorthand for calling the uncached version of TruffleString.ForceEncodingNode.
final TruffleString.CodeRange	getByteCodeRangeUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetByteCodeRangeNode.
final TruffleString.CodeRange	getCodeRangeImpreciseUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetCodeRangeImpreciseNode.
final TruffleString.CodeRange	getCodeRangeUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetCodeRangeNode.
final InternalByteArray	getInternalByteArrayUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetInternalByteArrayNode.
final Object	getInternalNativePointerUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetInternalNativePointerNode.
final TruffleString.CompactionLevel	getStringCompactionLevelUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.GetStringCompactionLevelNode.
final int	hashCode()	Returns this string's hashcode.
final int	hashCodeUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.HashCodeNode.
final int	indexOfCodePointUncached(int cp, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.IndexOfCodePointNode.
final int	indexOfStringUncached(AbstractTruffleString b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.IndexOfStringNode.
final int	intIndexOfAnyIntUTF32Uncached(int fromIntIndex, int maxIntIndex, int[] values)	Shorthand for calling the uncached version of TruffleString.IntIndexOfAnyIntUTF32Node.
final boolean	isCompatibleTo(TruffleString.Encoding expectedEncoding)	Deprecated. use isCompatibleToUncached(Encoding) instead.
final boolean	isCompatibleToUncached(TruffleString.Encoding expectedEncoding)	Returns true if this string is compatible to the given encoding.
final boolean	isEmpty()	Returns true if this string is empty.
final boolean	isImmutable()	Returns true if this string is immutable, i.e.
final boolean	isManaged()	Returns true if this string is not backed by a native pointer.
final boolean	isMutable()	Returns true if this string is mutable, i.e.
final boolean	isNative()	Returns true if this string is backed by a native pointer.
final boolean	isValidUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.IsValidNode.
final int	lastByteIndexOfCodePointUncached(int cp, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.LastByteIndexOfCodePointNode.
final int	lastByteIndexOfStringUncached(AbstractTruffleString b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.LastByteIndexOfStringNode.
final int	lastByteIndexOfStringUncached(TruffleString.WithMask b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.LastByteIndexOfStringNode.
final int	lastIndexOfCodePointUncached(int cp, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.LastIndexOfCodePointNode.
final int	lastIndexOfStringUncached(AbstractTruffleString b, int fromIndex, int toIndex, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.LastIndexOfStringNode.
void	materializeUncached(AbstractTruffleString a, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.MaterializeNode.
final double	parseDoubleUncached()	Shorthand for calling the uncached version of TruffleString.ParseDoubleNode.
final int	parseIntUncached()	Shorthand for calling the uncached version of TruffleString.ParseIntNode.
final int	parseIntUncached(int radix)	Shorthand for calling the uncached version of TruffleString.ParseIntNode.
final long	parseLongUncached()	Shorthand for calling the uncached version of TruffleString.ParseLongNode.
final long	parseLongUncached(int radix)	Shorthand for calling the uncached version of TruffleString.ParseLongNode.
final int	readByteUncached(int i, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ReadByteNode.
final int	readCharUTF16Uncached(int i)	Shorthand for calling the uncached version of TruffleString.ReadCharUTF16Node.
final boolean	regionEqualByteIndexUncached(int fromByteIndexA, AbstractTruffleString b, int fromByteIndexB, int byteLength, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.RegionEqualByteIndexNode.
final boolean	regionEqualByteIndexUncached(int fromByteIndexA, TruffleString.WithMask b, int fromByteIndexB, int byteLength, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.RegionEqualByteIndexNode.
final boolean	regionEqualsUncached(int fromIndexA, AbstractTruffleString b, int fromIndexB, int regionLength, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.RegionEqualNode.
final TruffleString	repeatUncached(int n, TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.RepeatNode.
final TruffleString	substringByteIndexUncached(int fromByteIndex, int byteLength, TruffleString.Encoding expectedEncoding, boolean lazy)	Shorthand for calling the uncached version of TruffleString.SubstringByteIndexNode.
final TruffleString	substringUncached(int fromIndex, int substringLength, TruffleString.Encoding expectedEncoding, boolean lazy)	Shorthand for calling the uncached version of TruffleString.SubstringNode.
final TruffleString	switchEncodingUncached(TruffleString.Encoding targetEncoding)	Shorthand for calling the uncached version of TruffleString.SwitchEncodingNode.
final TruffleString	switchEncodingUncached(TruffleString.Encoding targetEncoding, TranscodingErrorHandler errorHandler)	Shorthand for calling the uncached version of TruffleString.SwitchEncodingNode.
final String	toJavaStringUncached()	Shorthand for calling the uncached version of TruffleString.ToJavaStringNode.
final String	toString()	Returns a String representation of this string.
final String	toStringDebug()	Returns debug information about this string.
TruffleString	toValidStringUncached(TruffleString.Encoding expectedEncoding)	Shorthand for calling the uncached version of TruffleString.ToValidStringNode.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Details

isEmpty

public final boolean isEmpty()

Returns true if this string is empty. This method is allowed to be used on fast paths.

Since:

22.1

byteLength

public final int byteLength(TruffleString.Encoding expectedEncoding)

Get this string's length in bytes. This method is allowed to be used on fast paths.

Since:

22.1

isCompatibleTo

@Deprecated(since="23.0")
public final boolean isCompatibleTo(TruffleString.Encoding expectedEncoding)

Deprecated.

use isCompatibleToUncached(Encoding) instead.

Returns true if this string is compatible to the given encoding.

Since:

22.1

isCompatibleToUncached

public final boolean isCompatibleToUncached(TruffleString.Encoding expectedEncoding)

Returns true if this string is compatible to the given encoding. Compatible for TruffleString means it is byte-equivalent in both the encoding used to create this string and the given encoding. For MutableTruffleString this method only returned true if the passed encoding is the same encoding used to create this string.

Since:

23.0

isManaged

public final boolean isManaged()

Returns true if this string is not backed by a native pointer.

Since:

22.1

isNative

public final boolean isNative()

Returns true if this string is backed by a native pointer.

Since:

22.1

isImmutable

public final boolean isImmutable()

Returns true if this string is immutable, i.e. an instance of TruffleString.

Since:

22.1

isMutable

public final boolean isMutable()

Returns true if this string is mutable, i.e. an instance of MutableTruffleString.

Since:

22.1

asTruffleStringUncached

public final TruffleString asTruffleStringUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.FromByteArrayNode.

Since:

22.1

asManagedTruffleStringUncached

public final TruffleString asManagedTruffleStringUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.AsManagedNode.

Since:

22.1

asManagedTruffleStringUncached

public final TruffleString asManagedTruffleStringUncached(TruffleString.Encoding expectedEncoding,
 boolean cacheResult)

Shorthand for calling the uncached version of TruffleString.AsManagedNode.

Since:

23.0

asMutableTruffleStringUncached

public final MutableTruffleString asMutableTruffleStringUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of MutableTruffleString.AsMutableTruffleStringNode.

Since:

22.1

asManagedMutableTruffleStringUncached

public final MutableTruffleString asManagedMutableTruffleStringUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.AsManagedNode.

Since:

22.1

materializeUncached

public void materializeUncached(AbstractTruffleString a,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.MaterializeNode.

Since:

23.1

getCodeRangeUncached

public final TruffleString.CodeRange getCodeRangeUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetCodeRangeNode.

Since:

22.1

getCodeRangeImpreciseUncached

public final TruffleString.CodeRange getCodeRangeImpreciseUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetCodeRangeImpreciseNode.

Since:

23.0

getByteCodeRangeUncached

public final TruffleString.CodeRange getByteCodeRangeUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetByteCodeRangeNode.

Since:

22.1

codeRangeEqualsUncached

public final boolean codeRangeEqualsUncached(TruffleString.CodeRange otherCodeRange)

Shorthand for calling the uncached version of TruffleString.CodeRangeEqualsNode.

Since:

22.1

isValidUncached

public final boolean isValidUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.IsValidNode.

Since:

22.1

getStringCompactionLevelUncached

public final TruffleString.CompactionLevel getStringCompactionLevelUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetStringCompactionLevelNode.

Since:

23.0

codePointLengthUncached

public final int codePointLengthUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CodePointLengthNode.

Since:

22.1

hashCodeUncached

public final int hashCodeUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.HashCodeNode.

Since:

22.1

readByteUncached

public final int readByteUncached(int i,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ReadByteNode.

Since:

22.1

readCharUTF16Uncached

public final int readCharUTF16Uncached(int i)

Shorthand for calling the uncached version of TruffleString.ReadCharUTF16Node.

Since:

22.1

byteLengthOfCodePointUncached

public final int byteLengthOfCodePointUncached(int byteIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.

Since:

22.1

byteLengthOfCodePointUncached

public final int byteLengthOfCodePointUncached(int byteIndex,
 TruffleString.Encoding expectedEncoding,
 TruffleString.ErrorHandling errorHandling)

Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.

Since:

22.3

byteIndexToCodePointIndexUncached

public final int byteIndexToCodePointIndexUncached(int byteOffset,
 int byteIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ByteIndexToCodePointIndexNode.

Since:

22.2

codePointIndexToByteIndexUncached

public final int codePointIndexToByteIndexUncached(int byteOffset,
 int codepointIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CodePointIndexToByteIndexNode.

Since:

22.1

codePointAtIndexUncached

public final int codePointAtIndexUncached(int i,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CodePointAtIndexNode.

Since:

22.1

codePointAtIndexUncached

public final int codePointAtIndexUncached(int i,
 TruffleString.Encoding expectedEncoding,
 TruffleString.ErrorHandling errorHandling)

Shorthand for calling the uncached version of TruffleString.CodePointAtIndexNode.

Since:

22.3

codePointAtByteIndexUncached

public final int codePointAtByteIndexUncached(int i,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CodePointAtByteIndexNode.

Since:

22.1

codePointAtByteIndexUncached

public final int codePointAtByteIndexUncached(int i,
 TruffleString.Encoding expectedEncoding,
 TruffleString.ErrorHandling errorHandling)

Shorthand for calling the uncached version of TruffleString.CodePointAtByteIndexNode.

Since:

22.3

byteIndexOfAnyByteUncached

public final int byteIndexOfAnyByteUncached(int fromByteIndex,
 int maxByteIndex,
 byte[] values,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ByteIndexOfAnyByteNode.

Since:

22.1

charIndexOfAnyCharUTF16Uncached

public final int charIndexOfAnyCharUTF16Uncached(int fromCharIndex,
 int maxCharIndex,
 char[] values)

Shorthand for calling the uncached version of TruffleString.CharIndexOfAnyCharUTF16Node.

Since:

22.1

intIndexOfAnyIntUTF32Uncached

public final int intIndexOfAnyIntUTF32Uncached(int fromIntIndex,
 int maxIntIndex,
 int[] values)

Shorthand for calling the uncached version of TruffleString.IntIndexOfAnyIntUTF32Node.

Since:

22.1

indexOfCodePointUncached

public final int indexOfCodePointUncached(int cp,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.IndexOfCodePointNode.

Since:

22.1

byteIndexOfCodePointUncached

public final int byteIndexOfCodePointUncached(int cp,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ByteIndexOfCodePointNode.

Since:

22.1

lastIndexOfCodePointUncached

public final int lastIndexOfCodePointUncached(int cp,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.LastIndexOfCodePointNode.

Since:

22.1

lastByteIndexOfCodePointUncached

public final int lastByteIndexOfCodePointUncached(int cp,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.LastByteIndexOfCodePointNode.

Since:

22.1

indexOfStringUncached

public final int indexOfStringUncached(AbstractTruffleString b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.IndexOfStringNode.

Since:

22.1

byteIndexOfStringUncached

public final int byteIndexOfStringUncached(AbstractTruffleString b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ByteIndexOfStringNode.

Since:

22.1

byteIndexOfStringUncached

public final int byteIndexOfStringUncached(TruffleString.WithMask b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ByteIndexOfStringNode.

Since:

22.1

lastIndexOfStringUncached

public final int lastIndexOfStringUncached(AbstractTruffleString b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.LastIndexOfStringNode.

Since:

22.1

lastByteIndexOfStringUncached

public final int lastByteIndexOfStringUncached(AbstractTruffleString b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.LastByteIndexOfStringNode.

Since:

22.1

lastByteIndexOfStringUncached

public final int lastByteIndexOfStringUncached(TruffleString.WithMask b,
 int fromIndex,
 int toIndex,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.LastByteIndexOfStringNode.

Since:

22.1

compareBytesUncached

public final int compareBytesUncached(AbstractTruffleString b,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CompareBytesNode.

Since:

22.1

compareCharsUTF16Uncached

public final int compareCharsUTF16Uncached(AbstractTruffleString b)

Shorthand for calling the uncached version of TruffleString.CompareCharsUTF16Node.

Since:

22.1

compareIntsUTF32Uncached

public final int compareIntsUTF32Uncached(AbstractTruffleString b)

Shorthand for calling the uncached version of TruffleString.CompareIntsUTF32Node.

Since:

22.1

regionEqualsUncached

public final boolean regionEqualsUncached(int fromIndexA,
 AbstractTruffleString b,
 int fromIndexB,
 int regionLength,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.RegionEqualNode.

Since:

22.1

regionEqualByteIndexUncached

public final boolean regionEqualByteIndexUncached(int fromByteIndexA,
 AbstractTruffleString b,
 int fromByteIndexB,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.RegionEqualByteIndexNode.

Since:

22.1

regionEqualByteIndexUncached

public final boolean regionEqualByteIndexUncached(int fromByteIndexA,
 TruffleString.WithMask b,
 int fromByteIndexB,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.RegionEqualByteIndexNode.

Since:

22.1

concatUncached

public final TruffleString concatUncached(AbstractTruffleString b,
 TruffleString.Encoding expectedEncoding,
 boolean lazy)

Shorthand for calling the uncached version of TruffleString.ConcatNode.

Since:

22.1

repeatUncached

public final TruffleString repeatUncached(int n,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.RepeatNode.

Since:

22.1

substringUncached

public final TruffleString substringUncached(int fromIndex,
 int substringLength,
 TruffleString.Encoding expectedEncoding,
 boolean lazy)

Shorthand for calling the uncached version of TruffleString.SubstringNode.

Since:

22.1

substringByteIndexUncached

public final TruffleString substringByteIndexUncached(int fromByteIndex,
 int byteLength,
 TruffleString.Encoding expectedEncoding,
 boolean lazy)

Shorthand for calling the uncached version of TruffleString.SubstringByteIndexNode.

Since:

22.1

equalsUncached

public final boolean equalsUncached(AbstractTruffleString b,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.EqualNode.

Since:

22.1

parseIntUncached

public final int parseIntUncached()
                           throws TruffleString.NumberFormatException

Shorthand for calling the uncached version of TruffleString.ParseIntNode.

Throws:

TruffleString.NumberFormatException

Since:

22.1

parseIntUncached

public final int parseIntUncached(int radix)
                           throws TruffleString.NumberFormatException

Shorthand for calling the uncached version of TruffleString.ParseIntNode.

Throws:

TruffleString.NumberFormatException

Since:

22.1

parseLongUncached

public final long parseLongUncached()
                             throws TruffleString.NumberFormatException

Shorthand for calling the uncached version of TruffleString.ParseLongNode.

Throws:

TruffleString.NumberFormatException

Since:

22.1

parseLongUncached

public final long parseLongUncached(int radix)
                             throws TruffleString.NumberFormatException

Shorthand for calling the uncached version of TruffleString.ParseLongNode.

Throws:

TruffleString.NumberFormatException

Since:

22.1

parseDoubleUncached

public final double parseDoubleUncached()
                                 throws TruffleString.NumberFormatException

Shorthand for calling the uncached version of TruffleString.ParseDoubleNode.

Throws:

TruffleString.NumberFormatException

Since:

22.1

getInternalByteArrayUncached

public final InternalByteArray getInternalByteArrayUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetInternalByteArrayNode.

Since:

22.1

getInternalNativePointerUncached

public final Object getInternalNativePointerUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.GetInternalNativePointerNode.

Since:

22.1

copyToByteArrayUncached

public final byte[] copyToByteArrayUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CopyToByteArrayNode.

Since:

22.3

copyToByteArrayNodeUncached

@Deprecated(since="22.3")
public final void copyToByteArrayNodeUncached(int byteFromIndexA,
 byte[] dst,
 int byteFromIndexDst,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Deprecated.

since 22.3, use copyToByteArrayUncached(int, byte[], int, int, Encoding) instead.

Shorthand for calling the uncached version of TruffleString.CopyToByteArrayNode.

Since:

22.1

copyToByteArrayUncached

public final void copyToByteArrayUncached(int byteFromIndexA,
 byte[] dst,
 int byteFromIndexDst,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CopyToByteArrayNode.

Since:

22.1

copyToNativeMemoryNodeUncached

@Deprecated(since="22.3")
public final void copyToNativeMemoryNodeUncached(int byteFromIndexA,
 Object pointerObject,
 int byteFromIndexDst,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Deprecated.

since 22.3, use copyToNativeMemoryUncached(int, Object, int, int, Encoding) instead.

Shorthand for calling the uncached version of TruffleString.CopyToNativeMemoryNode.

Since:

22.1

copyToNativeMemoryUncached

public final void copyToNativeMemoryUncached(int byteFromIndexA,
 Object pointerObject,
 int byteFromIndexDst,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CopyToNativeMemoryNode.

Since:

22.1

toValidStringUncached

public TruffleString toValidStringUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.ToValidStringNode.

Since:

23.1

toJavaStringUncached

public final String toJavaStringUncached()

Shorthand for calling the uncached version of TruffleString.ToJavaStringNode.

Since:

22.1

switchEncodingUncached

public final TruffleString switchEncodingUncached(TruffleString.Encoding targetEncoding)

Shorthand for calling the uncached version of TruffleString.SwitchEncodingNode.

Since:

22.1

switchEncodingUncached

public final TruffleString switchEncodingUncached(TruffleString.Encoding targetEncoding,
 TranscodingErrorHandler errorHandler)

Shorthand for calling the uncached version of TruffleString.SwitchEncodingNode.

Since:

23.1

forceEncodingUncached

public final TruffleString forceEncodingUncached(TruffleString.Encoding expectedEncoding,
 TruffleString.Encoding targetEncoding)

Shorthand for calling the uncached version of TruffleString.ForceEncodingNode.

Since:

22.1

createCodePointIteratorUncached

public final TruffleStringIterator createCodePointIteratorUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CreateCodePointIteratorNode.

Since:

22.1

createBackwardCodePointIteratorUncached

public final TruffleStringIterator createBackwardCodePointIteratorUncached(TruffleString.Encoding expectedEncoding)

Shorthand for calling the uncached version of TruffleString.CreateBackwardCodePointIteratorNode.

Since:

22.1

equals

public final boolean equals(Object obj)

Returns true if this string is equal to obj. TruffleString does not attempt to automatically convert differently encoded strings during comparison, make sure to convert both strings to a common encoding before comparing them!

Overrides:

equals in class Object

Since:

22.1

See Also:

• TruffleString.EqualNode

hashCode

public final int hashCode()

Returns this string's hashcode. Note that the hashcode is dependent on the string's encoding, make sure to convert strings to a common encoding before comparing their hash codes!

Overrides:

hashCode in class Object

Since:

22.1

See Also:

• TruffleString.HashCodeNode

toString

public final String toString()

Returns a String representation of this string. Do not use this on fast paths.

Overrides:

toString in class Object

Since:

22.1

See Also:

• TruffleString.ToJavaStringNode

toStringDebug

public final String toStringDebug()

Returns debug information about this string. For debugging purposes only. The format of the information returned by this method is unspecified and may change at any time.

Since:

22.1