com.oracle.truffle.api.strings

Class TruffleString.ByteLengthOfCodePointNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleString.ByteLengthOfCodePointNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleString

public abstract static class TruffleString.ByteLengthOfCodePointNode
extends Node

Node to get the number of bytes occupied by the codepoint starting at a given byte index. See TruffleString.ByteLengthOfCodePointNode.execute(AbstractTruffleString, int, TruffleString.Encoding) for details.

Since:

22.1

Nested Class Summary

Nested classes/interfaces inherited from class com.oracle.truffle.api.nodes.Node

Node.Child, Node.Children

Method Summary

Modifier and Type	Method and Description
static TruffleString.ByteLengthOfCodePointNode	create() Create a new TruffleString.ByteLengthOfCodePointNode.
int	execute(AbstractTruffleString a, int byteIndex, TruffleString.Encoding expectedEncoding) Get the number of bytes occupied by the codepoint starting at byteIndex, with best-effort error handling.
abstract int	execute(AbstractTruffleString a, int byteIndex, TruffleString.Encoding expectedEncoding, TruffleString.ErrorHandling errorHandling) Get the number of bytes occupied by the codepoint starting at byteIndex.
static TruffleString.ByteLengthOfCodePointNode	getUncached() Get the uncached version of TruffleString.ByteLengthOfCodePointNode.

Methods inherited from class com.oracle.truffle.api.nodes.Node

accept, adoptChildren, atomic, atomic, copy, deepCopy, getChildren, getCost, getDebugProperties, getDescription, getEncapsulatingSourceSection, getLock, getParent, getRootNode, getSourceSection, insert, insert, isAdoptable, isSafelyReplaceableBy, notifyInserted, onReplace, replace, replace, reportPolymorphicSpecialize, toString

Methods inherited from class java.lang.Object

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

Method Detail

execute

public final int execute(AbstractTruffleString a,
                         int byteIndex,
                         TruffleString.Encoding expectedEncoding)

Get the number of bytes occupied by the codepoint starting at byteIndex, with best-effort error handling.

Since:

22.1

execute

public abstract int execute(AbstractTruffleString a,
                            int byteIndex,
                            TruffleString.Encoding expectedEncoding,
                            TruffleString.ErrorHandling errorHandling)

Get the number of bytes occupied by the codepoint starting at byteIndex.

Parameters:

errorHandling - if set to TruffleString.ErrorHandling.BEST_EFFORT, this node will return the encoding's minimum number of bytes per codepoint if an error occurs while reading the codepoint. If set to TruffleString.ErrorHandling.RETURN_NEGATIVE, a negative value will be returned instead, where two error cases are distinguished: if the codepoint is invalid, the return value is -1. If the codepoint is an unfinished, possibly valid byte sequence at the end of the string, the return value is -1 - (number of missing bytes). This parameter is expected to be partial evaluation constant.

Since:

22.3

create

public static TruffleString.ByteLengthOfCodePointNode create()

Create a new TruffleString.ByteLengthOfCodePointNode.

Since:

22.1

getUncached

public static TruffleString.ByteLengthOfCodePointNode getUncached()

Get the uncached version of TruffleString.ByteLengthOfCodePointNode.

Since:

22.1