Class TruffleString.CopyToByteArrayNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleString.CopyToByteArrayNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleString

public abstract static class TruffleString.CopyToByteArrayNode
extends Node

Node to copy a region of a string into a byte array. See execute(AbstractTruffleString, int, byte[], int, int, TruffleString.Encoding) for details.

Since:

22.1

Nested Class Summary

Nested classes/interfaces inherited from class Node

Node.Child, Node.Children

Modifier and Type	Class	Description
static @interface	Node.Child	Marks fields that represent child nodes of this node.
static @interface	Node.Children	Marks array fields that are children of this node.

Method Summary

Modifier and Type	Method	Description
static TruffleString.CopyToByteArrayNode	create()	Create a new TruffleString.CopyToByteArrayNode.
abstract void	execute(AbstractTruffleString a, int byteFromIndexA, byte[] dst, int byteFromIndexDst, int byteLength, TruffleString.Encoding expectedEncoding)	Copy a region of the given TruffleString a, bounded by byteFromIndexA and byteLength into the given byte array, at starting at byteFromIndexDst.
final byte[]	execute(AbstractTruffleString string, TruffleString.Encoding expectedEncoding)	Copy the entire string to a byte[] and return it.
static TruffleString.CopyToByteArrayNode	getUncached()	Get the uncached version of TruffleString.CopyToByteArrayNode.

Methods inherited from class 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, reportReplace, toString

Modifier and Type	Method	Description
final void	accept(NodeVisitor nodeVisitor)	Invokes the NodeVisitor.visit(Node) method for this node and recursively also for all child nodes.
final void	adoptChildren()
final void	atomic(Runnable closure)
final <T> T	atomic(Callable<T> closure)
Node	copy()	Creates a shallow copy of this node.
Node	deepCopy()	Creates a deep copy of this node.
final Iterable<Node>	getChildren()	Iterator over the children of this node.
NodeCost	getCost()	Deprecated. in 24.1 without replacement
Map<String,Object>	getDebugProperties()	Returns properties of this node interesting for debugging and can be overwritten by subclasses to add their own custom properties.
String	getDescription()	Returns a user-readable description of the purpose of the Node, or "" if no description is available.
SourceSection	getEncapsulatingSourceSection()	Retrieves the segment of guest language source code that is represented by this Node, if present; otherwise retrieves the segment represented by the nearest AST ancestor that has this information.
protected final Lock	getLock()	Returns a lock object that can be used to synchronize modifications to the AST.
final Node	getParent()	The current parent node of this node.
final RootNode	getRootNode()	Get the root node of the tree a node belongs to.
SourceSection	getSourceSection()	Retrieves the segment of guest language source code that is represented by this Node.
final <T extends Node> T	insert(T newChild)	Inserts an new node into an AST that was already adopted by a parent.
final <T extends Node> T[]	insert(T[] newChildren)	Inserts new node children into an AST that was already adopted by a parent.
boolean	isAdoptable()	Returns true if this node can be adopted by a parent.
final boolean	isSafelyReplaceableBy(Node newNode)	Checks if this node can be replaced by another node: tree structure & type.
protected final void	notifyInserted(Node node)	Notifies the framework about the insertion of one or more nodes during execution.
protected void	onReplace(Node newNode, CharSequence reason)	Intended to be implemented by subclasses of Node to receive a notification when the node is rewritten.
final <T extends Node> T	replace(T newNode)	Replaces this node with another node.
final <T extends Node> T	replace(T newNode, CharSequence reason)	Replaces this node with another node.
final void	reportPolymorphicSpecialize()	Notifies the runtime that this node specialized to a polymorphic state.
protected final void	reportReplace(Node oldNode, Node newNode, CharSequence reason)	Reports that oldNode was replaced with newNode, notifying any replace observers and invalidating any compiled call targets.
String	toString()	Converts this node to a textual representation useful for debugging.

Methods inherited from class Object

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

Method Details

execute

public final byte[] execute(AbstractTruffleString string,
 TruffleString.Encoding expectedEncoding)

Copy the entire string to a byte[] and return it.

Since:

22.2

execute

public abstract void execute(AbstractTruffleString a,
 int byteFromIndexA,
 byte[] dst,
 int byteFromIndexDst,
 int byteLength,
 TruffleString.Encoding expectedEncoding)

Copy a region of the given TruffleString a, bounded by byteFromIndexA and byteLength into the given byte array, at starting at byteFromIndexDst.

Since:

22.1

create

public static TruffleString.CopyToByteArrayNode create()

Create a new TruffleString.CopyToByteArrayNode.

Since:

22.1

getUncached

public static TruffleString.CopyToByteArrayNode getUncached()

Get the uncached version of TruffleString.CopyToByteArrayNode.

Since:

22.1