J avolution v5.2 (J2SE 1.5+)

javolution.text
Class CharSet

java.lang.Object
  extended by javolution.text.CharSet
All Implemented Interfaces:
Immutable

public final class CharSet
extends java.lang.Object
implements Immutable

This class represents a set of characters.

Instances of this class are typically used for parsing purpose (faster than regular expressions for simple patterns). For example:

     // Integration with Text.
     Text number;
     int exponentIndex = num.indexOfAny(CharSet.valueOf('e', 'E'));
     
     // Integration with TextFormat.
     public List<Integer> parse(CharSequence csq, TextFormat.Cursor cursor) {
         FastTable<Integer> numbers = FastTable.newInstance();
         while (cursor.skip(CharSet.WHITESPACES, csq)) {
             numbers.add(TypeFormat.parseInt(csq, cursor));
         }
         return numbers;
     }
     

Version:
3.7, January 1, 2006
Author:
Jean-Marie Dautelle

Field Summary
static CharSet EMPTY
          Represents an empty character set.
static CharSet ISO_CONTROLS
          Represents ISO control characters according to Java (see Character.isISOControl(char)).
static CharSet SPACES
          Represents spaces characters according to Java (see Character.isSpaceChar(char)).
static CharSet WHITESPACES
          Represents white spaces characters according to Java (see Character.isWhitespace(char)).
 
Method Summary
 boolean contains(char c)
          Indicates if the specified character is contained by this character set.
 CharSet minus(CharSet that)
          Returns the character set containing the characters from this character minus the characters from the character set specified.
 CharSet plus(CharSet that)
          Returns the character set containing the characters from this character set plus the characters from the character set specified.
static CharSet rangeOf(char first, char last)
          Returns the character set holding the characters in the specified range.
 java.lang.String toString()
          Returns the textual representation of this character set.
static CharSet valueOf(char... chars)
          Returns the character set holding the specified characters.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

EMPTY

public static final CharSet EMPTY
Represents an empty character set.


WHITESPACES

public static final CharSet WHITESPACES
Represents white spaces characters according to Java (see Character.isWhitespace(char)).


SPACES

public static final CharSet SPACES
Represents spaces characters according to Java (see Character.isSpaceChar(char)).


ISO_CONTROLS

public static final CharSet ISO_CONTROLS
Represents ISO control characters according to Java (see Character.isISOControl(char)).

Method Detail

valueOf

public static CharSet valueOf(char... chars)
Returns the character set holding the specified characters.

Parameters:
chars - the characters contained by this character set.
Returns:
the corresponding character set.

rangeOf

public static CharSet rangeOf(char first,
                              char last)
Returns the character set holding the characters in the specified range.

Parameters:
first - the first character.
last - the last character.
Returns:
the corresponding character set.
Throws:
java.lang.IllegalArgumentException - if first > last

contains

public boolean contains(char c)
Indicates if the specified character is contained by this character set.

Parameters:
c - the character to test.
Returns:
true if this character set contains the specified character; false otherwise.

plus

public CharSet plus(CharSet that)
Returns the character set containing the characters from this character set plus the characters from the character set specified.

Parameters:
that - the set containing the characters to be added.
Returns:
this + that

minus

public CharSet minus(CharSet that)
Returns the character set containing the characters from this character minus the characters from the character set specified.

Parameters:
that - the set containing the character to be removed.
Returns:
this - that

toString

public java.lang.String toString()
Returns the textual representation of this character set.

Overrides:
toString in class java.lang.Object
Returns:
the textual representation.

J avolution v5.2 (J2SE 1.5+)

Copyright © 2005 - 2007 Javolution.