com.oracle.truffle.api.strings

Class TruffleString.SwitchEncodingNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleString.SwitchEncodingNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleString

public abstract static class TruffleString.SwitchEncodingNode
extends Node

Node to get a given string in a specific encoding. See TruffleString.SwitchEncodingNode.execute(AbstractTruffleString, 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.SwitchEncodingNode	create() Create a new TruffleString.SwitchEncodingNode.
TruffleString	execute(AbstractTruffleString a, TruffleString.Encoding encoding) Returns a version of string a that is encoded in the given encoding, which may be the string itself or a converted version.
abstract TruffleString	execute(AbstractTruffleString a, TruffleString.Encoding encoding, TranscodingErrorHandler errorHandler) Returns a version of string a that is encoded in the given encoding, which may be the string itself or a converted version.
static TruffleString.SwitchEncodingNode	getUncached() Get the uncached version of TruffleString.SwitchEncodingNode.

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(AbstractTruffleString a,
                                   TruffleString.Encoding encoding)

Returns a version of string a that is encoded in the given encoding, which may be the string itself or a converted version. Note that 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 no lossless conversion is possible, the string is converted on a best-effort basis; no exception is thrown and characters which cannot be mapped in the target encoding are replaced by '�' (for UTF-*) or '?'.

Since:

22.1

execute

public abstract TruffleString execute(AbstractTruffleString a,
                                      TruffleString.Encoding encoding,
                                      TranscodingErrorHandler errorHandler)

Returns a version of string a that is encoded in the given encoding, which may be the string itself or a converted version. Note that 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. Transcoding errors are handled with errorHandler.

Since:

23.1

create

public static TruffleString.SwitchEncodingNode create()

Create a new TruffleString.SwitchEncodingNode.

Since:

22.1

getUncached

public static TruffleString.SwitchEncodingNode getUncached()

Get the uncached version of TruffleString.SwitchEncodingNode.

Since:

22.1