2018.2

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352.
When used to search through a Text file, the find() method returns a different region object
(see "region" on page350) 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 next 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350 and
"Example" on page352.
get(in_Region)
in_Region
A region object. What type of object this is depends on the type of source data, however in
any case the region object can be created with a call to region.createRegion(); see
"Example" on page352.
Page 332