com.oracle.truffle.api.strings

Class TruffleStringBuilder.ToStringNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleStringBuilder.ToStringNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleStringBuilder

public abstract static class TruffleStringBuilder.ToStringNode
extends Node

Node to materialize a string builder as a TruffleString.

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 TruffleStringBuilder.ToStringNode	create() Create a new TruffleStringBuilder.ToStringNode.
TruffleString	execute(TruffleStringBuilder sb) Materialize this string builder to a TruffleString.
abstract TruffleString	execute(TruffleStringBuilder sb, boolean lazy) Materialize this string builder to a TruffleString.
static TruffleStringBuilder.ToStringNode	getUncached() Get the uncached version of TruffleStringBuilder.ToStringNode.

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 TruffleString execute(TruffleStringBuilder sb)

Materialize this string builder to a TruffleString.

Since:

22.1

execute

public abstract TruffleString execute(TruffleStringBuilder sb,
                                      boolean lazy)

Materialize this string builder to a TruffleString. If lazy is true, sb's internal storage will be re-used even if there are unused bytes. Since the resulting string will have a reference to sb's internal storage, and TruffleString currently does not resize/trim the substring's internal storage at any point, the lazy variant effectively creates a memory leak! The caller is responsible for deciding whether this is acceptable or not.

Since:

22.1

create

public static TruffleStringBuilder.ToStringNode create()

Create a new TruffleStringBuilder.ToStringNode.

Since:

22.1

getUncached

public static TruffleStringBuilder.ToStringNode getUncached()

Get the uncached version of TruffleStringBuilder.ToStringNode.

Since:

22.1