TruffleStringBuilder (GraalVM Truffle Java API Reference)

java.lang.Object
- com.oracle.truffle.api.strings.TruffleStringBuilder

```
public final class TruffleStringBuilder
extends Object
```
The TruffleString equivalent to StringBuilder. This builder eagerly fills up a byte array with all strings passed to its Append-nodes. For lazy string concatenation, use TruffleString.ConcatNode instead.

Since:

22.1

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`TruffleStringBuilder.AppendByteNode` Node to append a single byte to a string builder.
`static class`	`TruffleStringBuilder.AppendCharUTF16Node` Node to append a single char to a string builder.
`static class`	`TruffleStringBuilder.AppendCodePointNode` Node to append a codepoint to a string builder.
`static class`	`TruffleStringBuilder.AppendIntNumberNode` Node to append an integer to a string builder.
`static class`	`TruffleStringBuilder.AppendJavaStringUTF16Node` Node to append a substring of a given `String` to a string builder.
`static class`	`TruffleStringBuilder.AppendLongNumberNode` Node to append a `long` value to a string builder.
`static class`	`TruffleStringBuilder.AppendStringNode` Node to append a given `TruffleString` to a string builder.
`static class`	`TruffleStringBuilder.AppendSubstringByteIndexNode` Node to append a substring of a given `TruffleString` to a string builder.
`static class`	`TruffleStringBuilder.ToStringNode` Node to materialize a string builder as a `TruffleString`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`appendByteUncached(byte value)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendByteNode`.
`void`	`appendCharUTF16Uncached(char value)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendCharUTF16Node`.
`void`	`appendCodePointUncached(int codepoint)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendCodePointNode`.
`void`	`appendCodePointUncached(int codepoint, int repeat)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendCodePointNode`.
`void`	`appendCodePointUncached(int codepoint, int repeat, boolean allowUTF16Surrogates)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendCodePointNode`.
`void`	`appendIntNumberUncached(int value)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendIntNumberNode`.
`void`	`appendJavaStringUTF16Uncached(String a)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendJavaStringUTF16Node`.
`void`	`appendJavaStringUTF16Uncached(String a, int fromCharIndex, int charLength)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendJavaStringUTF16Node`.
`void`	`appendLongNumberUncached(long value)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendLongNumberNode`.
`void`	`appendStringUncached(TruffleString a)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendStringNode`.
`void`	`appendSubstringByteIndexUncached(TruffleString a, int fromByteIndex, int byteLength)` Shorthand for calling the uncached version of `TruffleStringBuilder.AppendSubstringByteIndexNode`.
`int`	`byteLength()` Returns this string builder's byte length.
`static TruffleStringBuilder`	`create(TruffleString.Encoding encoding)` Create a new string builder with the given encoding.
`static TruffleStringBuilder`	`create(TruffleString.Encoding encoding, int initialCapacity)` Create a new string builder with the given encoding, and pre-allocate the given number of bytes.
`boolean`	`isEmpty()` Returns true if the this string builder is empty.
`String`	`toString()` Convert the string builder's content to a java string.
`TruffleString`	`toStringUncached()` Shorthand for calling the uncached version of `TruffleStringBuilder.ToStringNode`.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if the this string builder is empty.
    
    Since:
    
    22.1
  - byteLength
```
public int byteLength()
```
    Returns this string builder's byte length.
    
    Since:
    
    22.1
  - create
```
public static TruffleStringBuilder create(TruffleString.Encoding encoding)
```
    Create a new string builder with the given encoding.
    
    Since:
    
    22.1
  - create
```
public static TruffleStringBuilder create(TruffleString.Encoding encoding,
                                          int initialCapacity)
```
    Create a new string builder with the given encoding, and pre-allocate the given number of bytes.
    
    Since:
    
    22.1
  - appendByteUncached
```
public void appendByteUncached(byte value)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendByteNode.
    
    Since:
    
    22.1
  - appendCharUTF16Uncached
```
public void appendCharUTF16Uncached(char value)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendCharUTF16Node.
    
    Since:
    
    22.1
  - appendCodePointUncached
```
public void appendCodePointUncached(int codepoint)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendCodePointNode.
    
    Since:
    
    22.1
  - appendCodePointUncached
```
public void appendCodePointUncached(int codepoint,
                                    int repeat)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendCodePointNode.
    
    Since:
    
    22.2
  - appendCodePointUncached
```
public void appendCodePointUncached(int codepoint,
                                    int repeat,
                                    boolean allowUTF16Surrogates)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendCodePointNode.
    
    Since:
    
    22.2
  - appendIntNumberUncached
```
public void appendIntNumberUncached(int value)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendIntNumberNode.
    
    Since:
    
    22.1
  - appendLongNumberUncached
```
public void appendLongNumberUncached(long value)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendLongNumberNode.
    
    Since:
    
    22.1
  - appendStringUncached
```
public void appendStringUncached(TruffleString a)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendStringNode.
    
    Since:
    
    22.1
  - appendSubstringByteIndexUncached
```
public void appendSubstringByteIndexUncached(TruffleString a,
                                             int fromByteIndex,
                                             int byteLength)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendSubstringByteIndexNode.
    
    Since:
    
    22.1
  - appendJavaStringUTF16Uncached
```
public void appendJavaStringUTF16Uncached(String a)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendJavaStringUTF16Node.
    
    Since:
    
    22.1
  - appendJavaStringUTF16Uncached
```
public void appendJavaStringUTF16Uncached(String a,
                                          int fromCharIndex,
                                          int charLength)
```
    Shorthand for calling the uncached version of TruffleStringBuilder.AppendJavaStringUTF16Node.
    
    Since:
    
    22.1
  - toStringUncached
```
public TruffleString toStringUncached()
```
    Shorthand for calling the uncached version of TruffleStringBuilder.ToStringNode.
    
    Since:
    
    22.1
  - toString
```
public String toString()
```
    Convert the string builder's content to a java string. Do not use this on a fast path.
    
    Overrides:
    
    toString in class Object
    
    Since:
    
    22.1

Class TruffleStringBuilder

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

isEmpty

byteLength

create

create

appendByteUncached

appendCharUTF16Uncached

appendCodePointUncached

appendCodePointUncached

appendCodePointUncached

appendIntNumberUncached

appendLongNumberUncached

appendStringUncached

appendSubstringByteIndexUncached

appendJavaStringUTF16Uncached

appendJavaStringUTF16Uncached

toStringUncached

toString