org.codehaus.janino.util
Class StringPattern

java.lang.Object
  org.codehaus.janino.util.StringPattern

public class StringPattern

extends Object

Implementation of a UNIX shell-like string pattern algorithm.

Additionally, the concept of the "combined pattern" is supported (see matches(StringPattern[], String).

Field Summary

static int	EXCLUDE
static int	INCLUDE

Constructor Summary

StringPattern(int mode, String pattern)

Method Summary

int	getMode()
boolean	matches(String text) Match the given text against the pattern represented by the current instance, as follows: A * in the pattern matches any sequence of zero or more characters in the text A ? in the pattern matches exactly one character in the text Any other character in the pattern must appear exactly as it is in the text Notice: The mode flag of the current instance does not take any effect here.
static boolean	matches(StringPattern[] optionalPatterns, String text) Match a given text against an array of StringPatterns (which was typically created by parseCombinedPattern(String).
static StringPattern[]	parseCombinedPattern(String combinedPattern) Parse a "combined pattern" into an array of StringPatterns.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

INCLUDE

public static final int INCLUDE

See Also:

matches(StringPattern[], String), Constant Field Values

EXCLUDE

public static final int EXCLUDE

See Also:

matches(StringPattern[], String), Constant Field Values

Constructor Detail

StringPattern

public StringPattern(int mode,
                     String pattern)

Method Detail

getMode

public int getMode()

matches

public boolean matches(String text)

Match the given text against the pattern represented by the current instance, as follows:

• A * in the pattern matches any sequence of zero or more characters in the text
• A ? in the pattern matches exactly one character in the text
• Any other character in the pattern must appear exactly as it is in the text

Notice: The mode flag of the current instance does not take any effect here.

parseCombinedPattern

public static StringPattern[] parseCombinedPattern(String combinedPattern)

Parse a "combined pattern" into an array of StringPatterns. A combined pattern string is structured as follows:

   combined-pattern :=
     [ '+' | '-' ] pattern
     { ( '+' | '-' ) pattern }
 

If a pattern is preceeded with a '-', then the StringPattern is created with mode EXCLUDE, otherwise with mode INCLUDE.

matches

public static boolean matches(StringPattern[] optionalPatterns,
                              String text)

Match a given text against an array of StringPatterns (which was typically created by parseCombinedPattern(String).

The last matching pattern takes effect; if its mode is INCLUDE, then true is returned, if its mode is EXCLUDE, then false is returned.

If optionalPatterns is null, or empty, or none of its patterns matches, then false is returned.

toString

public String toString()