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().

 
  • Last Topic Update: 28, June, 2017 03:50 AM
  • Last Published: 23, May, 2019 01:55 PM