public Class SegmentConstantPool

A number of things make use of subsets of structures. In one particular example, _super bytecodes will use a subset of method or field classes which have just those methods / fields defined in the superclass. Similarly, _this bytecodes use just those methods/fields defined in this class, and _init bytecodes use just those methods that start with <init>. This method takes an array of names, a String to match for, an index and a boolean as parameters, and answers the array position in the array of the indexth element which matches (or equals) the String (depending on the state of the boolean) In other words, if the class array consists of: Object [position 0, 0th instance of Object] String [position 1, 0th instance of String] String [position 2, 1st instance of String] Object [position 3, 1st instance of Object] Object [position 4, 2nd instance of Object] then matchSpecificPoolEntryIndex(..., "Object", 2, false) will answer 4. matchSpecificPoolEntryIndex(..., "String", 0, false) will answer 1.

Parameters

nameArray:String[]

Array of Strings against which the compareString is tested

compareString:String

String for which to search

desiredIndex:int

nth element with that match (counting from 0)

Returns:int

int index into nameArray, or -1 if not found.

This method's function is to look through pairs of arrays. It keeps track of the number of hits it finds using the following basis of comparison for a hit: - the primaryArray[index] must be .equals() to the primaryCompareString - the secondaryArray[index] .matches() the secondaryCompareString. When the desiredIndex number of hits has been reached, the index into the original two arrays of the element hit is returned.

Parameters

primaryArray:String[]

The first array to search

secondaryArray:String[]

The second array (must be same .length as primaryArray)

primaryCompareString:String

The String to compare against primaryArray using .equals()

secondaryCompareRegex:String

The String to compare against secondaryArray using .matches()

desiredIndex:int

The nth hit whose position we're seeking

Returns:int

int index that represents the position of the nth hit in primaryArray and secondaryArray

We don't want a dependency on regex in Pack200. The only place one exists is in matchSpecificPoolEntryIndex(). To eliminate this dependency, we've implemented the world's stupidest regexMatch. It knows about the two forms we care about: .* (aka REGEX_MATCH_ALL) ^<init>;.* (aka REGEX_MATCH_INIT) and will answer correctly if those are passed as the regexString.

Parameters

regexString:String

String against which the compareString will be matched

compareString:String

String to match against the regexString

Returns:boolean

boolean true if the compareString matches the regexString; otherwise false.