Class CodePointBuilder

java.lang.Object
de.xima.fc.common.text.CodePointBuilder
public final class CodePointBuilder extends Object
A builder for a string of code points.
Since:
8.4.0

  • Constructor Summary

    Constructors
    Constructor
    Description
    CodePointBuilder()
    Creates a new CodePointBuilder with an initial capacity of 0 and no code points.
    CodePointBuilder(int initialCapacity)
    Creates a new CodePointBuilder with the specified initial capacity and a length of 0.
    CodePointBuilder(int[] codePoints)
    Creates a new CodePointBuilder with the specified initial code points.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    append(String value)
    Appends a string to this code point builder.
    void
    appendCodePoint(int codePoint)
    Appends a code point to this builder.
    void
    appendCodePoints(int[] newCodePoints)
    Appends an array of code points to this builder.
    int
    codePointAt(int index)
    Gets the code point at the specified index.
    int
    lastCodePoint()
    Gets the code point at the current position of this builder.
    int
    length()
    Gets the length of the code points in this builder.
    int[]
    rawCodePointsArray()
    Provides direct access to the raw underlying array of code points.
    void
    setLength(int newLength)
    Sets the length of the code points in this builder.
    String
    toString()
    Creates a string with the code points in this builder.

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • CodePointBuilder

      public CodePointBuilder()
      Creates a new CodePointBuilder with an initial capacity of 0 and no code points.

    • CodePointBuilder

      public CodePointBuilder(int[] codePoints)
      Creates a new CodePointBuilder with the specified initial code points.
      Parameters:
      codePoints - The code points to initialize this builder with.

    • CodePointBuilder

      public CodePointBuilder(int initialCapacity)
      Creates a new CodePointBuilder with the specified initial capacity and a length of 0.
      Parameters:
      initialCapacity - The initial capacity of the code points in this builder.

  • Method Details

    • append

      public void append(String value)
      Appends a string to this code point builder.
      Parameters:
      value - The string to append.

    • appendCodePoint

      public void appendCodePoint(int codePoint)
      Appends a code point to this builder.
      Parameters:
      codePoint - The code point to append.

    • appendCodePoints

      public void appendCodePoints(int[] newCodePoints)
      Appends an array of code points to this builder.
      Parameters:
      newCodePoints - The code points to append.

    • codePointAt

      public int codePointAt(int index)
      Gets the code point at the specified index.
      Parameters:
      index - The index of the code point to get. Must be between 0 and - 1.
      Throws:
      IndexOutOfBoundsException - if the index is out of bounds.

    • lastCodePoint

      public int lastCodePoint()
      Gets the code point at the current position of this builder.
      Returns:
      The last code point in this builder.
      Throws:
      IndexOutOfBoundsException - if there are no code points in this builder.

    • length

      public int length()
      Gets the length of the code points in this builder.
      Returns:
      The number of code points in this builder.

    • rawCodePointsArray

      public int[] rawCodePointsArray()
      Provides direct access to the raw underlying array of code points. This method should be used with caution. Consider the array to be read-only, as modifying it directly may lead to unexpected behavior in this builder. The array may be longer than length(), only the first length() elements are meaningful.
      Returns:
      The raw array of code points in this builder.

    • setLength

      public void setLength(int newLength)
      Sets the length of the code points in this builder. All code points between the current length and the new length are set to the code point 0.
      Parameters:
      newLength - The new length of the code points in this builder. Must not be negative.
      Throws:
      IndexOutOfBoundsException - if the new length is negative.

    • toString

      public String toString()
      Creates a string with the code points in this builder.
      Overrides:
      toString in class Object
      Returns:
      A string with the code points in this builder.