com.codename1.util.regex

Class REProgram

java.lang.Object

com.codename1.util.regex.REProgram

public class REProgram
extends Object

A class that holds compiled regular expressions. You should not need to work directly with this class.

See Also:

RE, RECompiler

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
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.
char[]	getPrefix() Returns a copy of the prefix of current regular expression program in a character array.
void	setInstructions(char[] instruction, int lenInstruction) Sets a new regular expression program to run.

Methods inherited from class java.lang.Object

clone, equals, 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(int parens,
                 char[] instruction)

Constructs a program object from a character array

Parameters:

parens - Count of parens in the program

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 a 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

getPrefix

public char[] getPrefix()

Returns a copy of the prefix of current regular expression program in a character array. If there is no prefix, or there is no program compiled yet, getPrefix will return null.

Returns:

A copy of the prefix of current compiled RE program