2018.1

find(stringToFind, in_Region)
Finds the string stringToFind in a rectangular region defined by in_Region.
stringToFind
String to find.
in_Region
The in_Region region 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 "Example" on
page339.
When used to search through a Text file, the find() method returns a different region object
(see "region" on page337) 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 "Example" on
the facing page.
Example
This script sets a boundary when the text TOTALis found on the current page in a PDFfile.
The number of delimiters is set to 1, so the boundary is set on the next delimiter, which is the
start of the next page.
if (boundaries.find("TOTAL", region.createRegion
(10,10,215,279)).found) {
boundaries.set(1);
}
get()
The get() method reads the contents of a region object and converts it into an array of strings
(because any region may contain several lines).
How the region is defined, depends on the type of source data; see "region" on page337 and
"Example" on page339.
get(in_Region)
in_Region
Page 319