com.oracle.truffle.api.strings

Class TruffleString.ForceEncodingNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleString.ForceEncodingNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleString

public abstract static class TruffleString.ForceEncodingNode
extends Node

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

Returns a version of string a assigned to the given encoding, which may be the string itself or a new string. The string itself may be returned even if it was originally created using a different encoding, if the string is byte-equivalent in both encodings. If the string is not byte-equivalent in both encodings, a new string containing the same 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 TruffleString.ForceEncodingNode create()

Create a new TruffleString.ForceEncodingNode.

Since:

22.1

getUncached

public static TruffleString.ForceEncodingNode getUncached()

Get the uncached version of TruffleString.ForceEncodingNode.

Since:

22.1