Package org.apache.commons.lang3

Class CharSequenceUtils

  • public class CharSequenceUtils
extends java.lang.Object

    Operations on CharSequence that are null safe.

    Since:
    3.0
    See Also:
    CharSequence

    • Constructor Summary

      Constructors 
      Constructor Description
      CharSequenceUtils()
      CharSequenceUtils instances should NOT be constructed in standard programming.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.CharSequence subSequence​(java.lang.CharSequence cs, int start)
      Returns a new CharSequence that is a subsequence of this sequence starting with the char value at the specified index.
      static char[] toCharArray​(java.lang.CharSequence source)
      Converts the given CharSequence to a char[].

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • CharSequenceUtils

        public CharSequenceUtils()

        CharSequenceUtils instances should NOT be constructed in standard programming.

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

    • Method Detail

      • subSequence

        public static java.lang.CharSequence subSequence​(java.lang.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:
        java.lang.IndexOutOfBoundsException - if start is negative or if start is greater than length()

      • toCharArray

        public static char[] toCharArray​(java.lang.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