001: /*
002: * $Id: substituteExample.java,v 1.9 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 org.apache.oro.text.regex.*;
061:
062: /**
063: * This is a test program demonstrating the use of the Util.substitute()
064: * method.
065: *
066: * @version @version@
067: */
068: public final class substituteExample {
069:
070: /**
071: * A good way for you to understand the substitute() method is to play around
072: * with it by using this test program. The program takes 3 to 5 arguments
073: * as follows:
074: * java substituteExample
075: * regex substitution input [sub limit] [interpolation limit]
076: * regex - A regular expression used to find parts of the input to be
077: * substituted.
078: * sub limit - An optional argument limiting the number of substitutions.
079: * If no limit is given, the limit used is Util.SUBSTITUTE_ALL.
080: * input - A string to be used as input for substitute().
081: * interpolation limit - An optional argument limiting the number of
082: * interpolations performed.
083: *
084: * Try the following command line for a simple example of subsitute().
085: * It changes (2,3) to (3,2) in the input.
086: * java substituteExample '\(2,3\)' '(3, 2)' '(1,2) (2,3) (4,5)'
087: *
088: * The following command line shows the substitute limit at work. It
089: * changed the first four 1's in the input to 4's.
090: * java substituteExample "1" "4" "381298175 1111" "4"
091: *
092: * The next command line shows how to use interpolations. Suppose we
093: * want to reverse the coordinates of the first 3 entries in the input
094: * and then have all the rest of the coordinates be equal to the new 3rd
095: * entry:
096: java substituteExample '\((\d+),(\d+)\)' '($2,$1)' '(1,2) (2,3) (4,5) (8,8) (9,2)' 5 3
097: *
098: */
099: public static final void main(String args[]) {
100: int limit, interps;
101: PatternMatcher matcher = new Perl5Matcher();
102: Pattern pattern = null;
103: PatternCompiler compiler = new Perl5Compiler();
104: String regularExpression, input, sub, result;
105:
106: // Make sure there are sufficient arguments
107: if (args.length < 3) {
108: System.err
109: .println("Usage: substituteExample regex substitution "
110: + "input [sub limit] [interpolation limit]");
111: System.exit(1);
112: }
113:
114: limit = Util.SUBSTITUTE_ALL;
115: interps = Perl5Substitution.INTERPOLATE_ALL;
116:
117: regularExpression = args[0];
118: sub = args[1];
119: input = args[2];
120:
121: if (args.length > 3)
122: limit = Integer.parseInt(args[3]);
123:
124: if (args.length > 4)
125: interps = Integer.parseInt(args[4]);
126:
127: try {
128: pattern = compiler.compile(regularExpression);
129: System.out
130: .println("substitute regex: " + regularExpression);
131: } catch (MalformedPatternException e) {
132: System.err.println("Bad pattern.");
133: System.err.println(e.getMessage());
134: System.exit(1);
135: }
136:
137: // Perform substitution and print result.
138: result = Util.substitute(matcher, pattern,
139: new Perl5Substitution(sub, interps), input, limit);
140: System.out.println("result: " + result);
141: }
142: }
|