Class CharSequenceUtils

java.lang.Object
org.apache.commons.lang3.CharSequenceUtils

public class CharSequenceUtils extends Object
Operations on CharSequence that are null safe.
Since:
3.0
See Also:
  • Constructor Details

    • CharSequenceUtils

      Deprecated.
      TODO Make private in 4.0.
      CharSequenceUtils instances should NOT be constructed in standard programming.

      This constructor is public to permit tools that require a JavaBean instance to operate.

  • Method Details

    • subSequence

      public static CharSequence subSequence(CharSequence cs, int start)
      Returns a new CharSequence that is a subsequence of this sequence starting with the char value at the specified index.

      This provides the CharSequence equivalent to String.substring(int). The length (in char) of the returned sequence is length() - start, so if start == end then an empty sequence is returned.

      Parameters:
      cs - the specified subsequence, null returns null
      start - the start index, inclusive, valid
      Returns:
      a new subsequence, may be null
      Throws:
      IndexOutOfBoundsException - if start is negative or if start is greater than length()
    • toCharArray

      public static char[] toCharArray(CharSequence source)
      Converts the given CharSequence to a char[].
      Parameters:
      source - the CharSequence to be processed.
      Returns:
      the resulting char array, never null.
      Since:
      3.11