org.apache.regexp
Class REProgram

java.lang.Object
  |
  +--org.apache.regexp.REProgram

public class REProgram

extends java.lang.Object

A class that holds compiled regular expressions. This is exposed mainly for use by the recompile utility (which helps you produce precompiled REProgram objects). You should not otherwise need to work directly with this class.

See Also:

RE, RECompiler

Constructor Summary

REProgram(char[] instruction)
Constructs a program object from a character array

REProgram(char[] instruction, int lenInstruction)
Constructs a program object from a character array

Method Summary

char[]	getInstructions() Returns a copy of the current regular expression program in a character array that is exactly the right length to hold the program.
void	setInstructions(char[] instruction, int lenInstruction) Sets a new regular expression program to run.

Methods inherited from class java.lang.Object

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

Constructor Detail

REProgram

public REProgram(char[] instruction)

Constructs a program object from a character array

Parameters:

instruction - Character array with RE opcode instructions in it

REProgram

public REProgram(char[] instruction,
                 int lenInstruction)

Constructs a program object from a character array

Parameters:

instruction - Character array with RE opcode instructions in it

lenInstruction - Amount of instruction array in use

Method Detail

getInstructions

public char[] getInstructions()

Returns a copy of the current regular expression program in a character array that is exactly the right length to hold the program. If there is no program compiled yet, getInstructions() will return null.

Returns:

A copy of the current compiled RE program

setInstructions

public void setInstructions(char[] instruction,
                            int lenInstruction)

Sets a new regular expression program to run. It is this method which performs any special compile-time search optimizations. Currently only two optimizations are in place - one which checks for backreferences (so that they can be lazily allocated) and another which attempts to find an prefix anchor string so that substantial amounts of input can potentially be skipped without running the actual program.

Parameters:

instruction - Program instruction buffer

lenInstruction - Length of instruction buffer in use