find()
Method of the boundaries object that finds a string in a region of the data source file. The method returns a smaller region which points to the exact location where the match was found.
find(stringToFind, in_Region)
Finds the string stringToFind in a rectangular region defined by inRegion.
stringToFind
String to find.
in_Region
The inRegion can be created prior to the call to find() with the region.createRegion() method. It depends on the type of data source how a region is defined; see createRegion().
The find() method returns a different region object whose range property is adjusted to point to the exact physical location where the match was found. This will always be a subset of the in_Region.range property. It can be used to determine the exact location where the match occurred.
Use boundaries.get() to retrieve the actual text from the resulting region; see get().
|
|