com.oracle.truffle.api.strings

Class MutableTruffleString.ForceEncodingNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.MutableTruffleString.ForceEncodingNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

MutableTruffleString

public abstract static class MutableTruffleString.ForceEncodingNode
extends Node

Node to forcibly assign any encoding to a string. See MutableTruffleString.ForceEncodingNode.execute(AbstractTruffleString, TruffleString.Encoding, 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 MutableTruffleString.ForceEncodingNode	create() Create a new MutableTruffleString.ForceEncodingNode.
abstract MutableTruffleString	execute(AbstractTruffleString a, TruffleString.Encoding expectedEncoding, TruffleString.Encoding targetEncoding) Returns a version of string a assigned to the given encoding.
static MutableTruffleString.ForceEncodingNode	getUncached() Get the uncached version of MutableTruffleString.ForceEncodingNode.

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 abstract MutableTruffleString execute(AbstractTruffleString a,
                                             TruffleString.Encoding expectedEncoding,
                                             TruffleString.Encoding targetEncoding)

Returns a version of string a assigned to the given encoding. If the string is already in the given encoding, it is returned. Otherwise, a new string containing the same (copied) bytes but assigned to the new encoding is returned. This node does not transcode the string's contents in any way, it is the "encoding-equivalent" to a C-style reinterpret-cast.

Since:

22.1

create

public static MutableTruffleString.ForceEncodingNode create()

Create a new MutableTruffleString.ForceEncodingNode.

Since:

22.1

getUncached

public static MutableTruffleString.ForceEncodingNode getUncached()

Get the uncached version of MutableTruffleString.ForceEncodingNode.

Since:

22.1