/*-------------------------------------------------------------------------
 * rbe.util.AbCharStrPattern.java
 * Timothy Heil
 * 10/5/99
 *
 * Abstract StringPattern template for single character matching patterns.
 *------------------------------------------------------------------------
 *
 * This is part of the the Java TPC-W distribution,
 * written by Harold Cain, Tim Heil, Milo Martin, Eric Weglarz, and Todd
 * Bezenek.  University of Wisconsin - Madison, Computer Sciences
 * Dept. and Dept. of Electrical and Computer Engineering, as a part of
 * Prof. Mikko Lipasti's Fall 1999 ECE 902 course.
 *
 * Copyright (C) 1999, 2000 by Harold Cain, Timothy Heil, Milo Martin, 
 *                             Eric Weglarz, Todd Bezenek.
 *
 * This source code is distributed "as is" in the hope that it will be
 * useful.  It comes with no warranty, and no author or distributor
 * accepts any responsibility for the consequences of its use.
 *
 * Everyone is granted permission to copy, modify and redistribute
 * this code under the following conditions:
 *
 * This code is distributed for non-commercial use only.
 * Please contact the maintainer for restrictions applying to 
 * commercial use of these tools.
 *
 * Permission is granted to anyone to make or distribute copies
 * of this code, either as received or modified, in any
 * medium, provided that all copyright notices, permission and
 * nonwarranty notices are preserved, and that the distributor
 * grants the recipient permission for further redistribution as
 * permitted by this document.
 *
 * Permission is granted to distribute this code in compiled
 * or executable form under the same conditions that apply for
 * source code, provided that either:
 *
 * A. it is accompanied by the corresponding machine-readable
 *    source code,
 * B. it is accompanied by a written offer, with no time limit,
 *    to give anyone a machine-readable copy of the corresponding
 *    source code in return for reimbursement of the cost of
 *    distribution.  This written offer must permit verbatim
 *    duplication by anyone, or
 * C. it is distributed by someone who received only the
 *    executable form, and is accompanied by a copy of the
 *    written offer of source code that they received concurrently.
 *
 * In other words, you are welcome to use, share and improve this codes.
 * You are forbidden to forbid anyone else to use, share and improve what
 * you give them.
 *
 ************************************************************************/

package rbe.util;

public abstract class AbCharStrPattern extends StringPattern {

  // Search from index start to end, inclusive.
  public int find(String s, int start, int end) 
  {
    int i;

    for (i=start;i<=end;i++) {
      if (charMatch(s.charAt(i))) {
	this.start = i;
	this.end = i;
	return(i);
      }
    }

    return(-1);
  }

  // See if pattern matches exactly characters pos to end, inclusive.
  public boolean matchWithin(String s, int pos, int end)
  {
    if (charMatch(s.charAt(pos))) {
      this.start = this.end = pos;
      return(true);
    }
    else {
      return(false);
    }    
  }

  // Minimum and maximum lengths.
  protected int minLength() {return(1);}
  protected int maxLength() {return(1);}

  // Does this character match.
  protected abstract boolean charMatch(char c);
}