/**
* Gets the cell whose contents match the regular expressionstring passed in. If no match is
* found, then null is returned. The search is performed on a row by row basis, so the lower the
* row number, the more efficiently the algorithm will perform
*
* @param pattern the regular expression string to match
* @param firstCol the first column within the range
* @param firstRow the first row of the range
* @param lastRow the last row within the range
* @param lastCol the last column within the ranage
* @param reverse indicates whether to perform a reverse search or not
* @return the Cell whose contents match the parameter, null if not found
*/
public Cell findCell(
Pattern pattern, int firstCol, int firstRow, int lastCol, int lastRow, boolean reverse) {
CellFinder cellFinder = new CellFinder(this);
return cellFinder.findCell(pattern, firstCol, firstRow, lastCol, lastRow, reverse);
}
/**
* Gets the cell whose contents match the string passed in. If no match is found, then null is
* returned. The search is performed on a row by row basis, so the lower the row number, the more
* efficiently the algorithm will perform. This method differs from the findCell methods in that
* only cells with labels are queried - all numerical cells are ignored. This should therefore
* improve performance.
*
* @param contents the string to match
* @return the Cell whose contents match the paramter, null if not found
*/
public LabelCell findLabelCell(String contents) {
CellFinder cellFinder = new CellFinder(this);
return cellFinder.findLabelCell(contents);
}
/**
* Gets the cell whose contents match the string passed in. If no match is found, then null is
* returned. The search is performed on a row by row basis, so the lower the row number, the more
* efficiently the algorithm will perform
*
* @param contents the string to match
* @param firstCol the first column within the range
* @param firstRow the first row of the range
* @param lastCol the last column within the range
* @param lastRow the last row within the range
* @param reverse indicates whether to perform a reverse search or not
* @return the Cell whose contents match the parameter, null if not found
*/
public Cell findCell(
String contents, int firstCol, int firstRow, int lastCol, int lastRow, boolean reverse) {
CellFinder cellFinder = new CellFinder(this);
return cellFinder.findCell(contents, firstCol, firstRow, lastCol, lastRow, reverse);
}