sunlabs.brazil.util

Class Glob

java.lang.Object

sunlabs.brazil.util.Glob

public class Glob
extends java.lang.Object

Glob-style string matching and substring extraction. Glob was implemented by translating the glob package for tcl8.0.

• "*" matches 0 or more characters
• "?" matches a single character
• "[...]" matches a set and/or range of characters
• "\" following character is not special

Each of the substrings matching (?, *, or [..]) are returned.

Version:

2.16

Author:

Colin Stevens (colin.stevens@sun.com)

Method Summary

Modifier and Type	Method and Description
static boolean	match(java.lang.String pattern, java.lang.String string) Match a string against a pattern.
static boolean	match(java.lang.String pattern, java.lang.String string, java.lang.String[] substr) Match a string against a pattern, and return sub-matches.

Methods inherited from class java.lang.Object

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

Method Detail

match

public static boolean match(java.lang.String pattern,
                            java.lang.String string)

Match a string against a pattern.

Parameters:

pattern - Glob pattern. Nothing matches if pattern==null.

string - String to match against pattern.

Returns:

true if the string matched the pattern, false otherwise.

match

public static boolean match(java.lang.String pattern,
                            java.lang.String string,
                            java.lang.String[] substr)

Match a string against a pattern, and return sub-matches.

The caller can provide an array of strings that will be filled in with the substrings of string that matched the glob meta-characters in pattern. The array of strings may be partially modified even if the string did not match the glob pattern. The array may contain more elements than glob meta-characters, in which case those extra elements will not be modified; the array may also contain fewer elements or even be null, to ignore some or all of the glob meta-characters. In other words, the user can pass pretty much anything and this method defines errors out of existence.

Parameters:

pattern - Glob pattern.

string - String to match against pattern.

substr - Array of strings provided by the caller, to be filled in with the substrings that matched the glob meta-characters. May be null.

Returns:

true if the string matched the pattern, false otherwise.