001: /*
002: * $Id: splitExample.java,v 1.8 2003/11/07 20:16:23 dfs Exp $
003: *
004: * ====================================================================
005: * The Apache Software License, Version 1.1
006: *
007: * Copyright (c) 2000 The Apache Software Foundation. All rights
008: * reserved.
009: *
010: * Redistribution and use in source and binary forms, with or without
011: * modification, are permitted provided that the following conditions
012: * are met:
013: *
014: * 1. Redistributions of source code must retain the above copyright
015: * notice, this list of conditions and the following disclaimer.
016: *
017: * 2. Redistributions in binary form must reproduce the above copyright
018: * notice, this list of conditions and the following disclaimer in
019: * the documentation and/or other materials provided with the
020: * distribution.
021: *
022: * 3. The end-user documentation included with the redistribution,
023: * if any, must include the following acknowledgment:
024: * "This product includes software developed by the
025: * Apache Software Foundation (http://www.apache.org/)."
026: * Alternately, this acknowledgment may appear in the software itself,
027: * if and wherever such third-party acknowledgments normally appear.
028: *
029: * 4. The names "Apache" and "Apache Software Foundation", "Jakarta-Oro"
030: * must not be used to endorse or promote products derived from this
031: * software without prior written permission. For written
032: * permission, please contact apache@apache.org.
033: *
034: * 5. Products derived from this software may not be called "Apache"
035: * or "Jakarta-Oro", nor may "Apache" or "Jakarta-Oro" appear in their
036: * name, without prior written permission of the Apache Software Foundation.
037: *
038: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
039: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
040: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
041: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
042: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
043: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
044: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
045: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
046: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
047: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
048: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
049: * SUCH DAMAGE.
050: * ====================================================================
051: *
052: * This software consists of voluntary contributions made by many
053: * individuals on behalf of the Apache Software Foundation. For more
054: * information on the Apache Software Foundation, please see
055: * <http://www.apache.org/>.
056: */
057:
058: package examples;
059:
060: import java.util.*;
061: import org.apache.oro.text.regex.*;
062:
063: /**
064: * This is a test program demonstrating the use of the Util.split() method.
065: *
066: * @version @version@
067: */
068: public final class splitExample {
069:
070: /**
071: * A good way for you to understand the split() method is to play around
072: * with it by using this test program. The program takes 2 or 3 arguments
073: * as follows:
074: * java splitExample regex input [split limit]
075: * regex - A regular expression used to split the input.
076: * input - A string to be used as input for split().
077: * split limit - An optional argument limiting the size of the list returned
078: * by split(). If no limit is given, the limit used is
079: * Util.SPLIT_ALL. Setting the limit to 1 generally doesn't
080: * make any sense.
081: *
082: * Try the following two command lines to see how split limit works:
083: * java splitExample '[:|]' '1:2|3:4'
084: * java splitExample '[:|]' '1:2|3:4' 3
085: *
086: */
087: public static final void main(String args[]) {
088: int limit, i;
089: String regularExpression, input;
090: List results = new ArrayList();
091: Pattern pattern = null;
092: PatternMatcher matcher;
093: PatternCompiler compiler;
094: Iterator elements;
095:
096: // Make sure there are sufficient arguments
097: if (args.length < 2) {
098: System.err
099: .println("Usage: splitExample regex input [split limit]");
100: System.exit(1);
101: }
102:
103: regularExpression = args[0];
104: input = args[1];
105:
106: if (args.length > 2)
107: limit = Integer.parseInt(args[2]);
108: else
109: limit = Util.SPLIT_ALL;
110:
111: // Create Perl5Compiler and Perl5Matcher instances.
112: compiler = new Perl5Compiler();
113: matcher = new Perl5Matcher();
114:
115: // Attempt to compile the pattern. If the pattern is not valid,
116: // report the error and exit.
117: try {
118: pattern = compiler.compile(regularExpression);
119: System.out.println("split regex: " + regularExpression);
120: } catch (MalformedPatternException e) {
121: System.err.println("Bad pattern.");
122: System.err.println(e.getMessage());
123: System.exit(1);
124: }
125:
126: // Split the input and print the resulting list.
127: System.out.println("split results: ");
128: Util.split(results, matcher, pattern, input, limit);
129: elements = results.iterator();
130:
131: i = 0;
132: while (elements.hasNext())
133: System.out.println("item " + i++ + ": "
134: + (String) elements.next());
135:
136: }
137: }
|