org.apache.commons.lang3
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

Version:

$Id: CharSequenceUtils.java 1091471 2011-04-12 15:34:43Z scolebourne $

See Also:

CharSequence

Constructor Summary

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

Method Summary

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.

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 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()