com.oracle.truffle.api.strings

Class TruffleString.ToValidStringNode

java.lang.Object

com.oracle.truffle.api.nodes.Node

com.oracle.truffle.api.strings.TruffleString.ToValidStringNode

All Implemented Interfaces:

NodeInterface, Cloneable

Enclosing class:

TruffleString

public abstract static class TruffleString.ToValidStringNode
extends Node

Node to replace all invalid bytes in a given string, such that the resulting string is valid. See TruffleString.ToValidStringNode.execute(AbstractTruffleString, TruffleString.Encoding) for details.

Since:

23.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.ToValidStringNode	create() Create a new TruffleString.SwitchEncodingNode.
abstract TruffleString	execute(AbstractTruffleString a, TruffleString.Encoding expectedEncoding) Returns a version of string a that contains only valid codepoints, which may be the string itself or a converted version.
static TruffleString.ToValidStringNode	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 abstract TruffleString execute(AbstractTruffleString a,
                                      TruffleString.Encoding expectedEncoding)

Returns a version of string a that contains only valid codepoints, which may be the string itself or a converted version. Invalid byte sequences are replaced with '�' (for UTF-*) or '?'. This is useful for string sanitization in all uses cases where a string is required to actually be valid, such as libraries that actively reject broken input, network and file system I/O, etc.

Since:

23.1

create

public static TruffleString.ToValidStringNode create()

Create a new TruffleString.SwitchEncodingNode.

Since:

23.1

getUncached

public static TruffleString.ToValidStringNode getUncached()

Get the uncached version of TruffleString.SwitchEncodingNode.

Since:

23.1