2019.2

extract()
Extracts the text value from selected data: a node path, column, or rectangular region,
depending on the type of data source.
This method always returns a String.
extract(left, right, verticalOffset, regionHeight, separator)
Extracts a value from a position in a text file. Coordinates are expressed as characters
(horizontally) or lines (vertically).
left
Number that represents the distance, measured in characters, from the left edge of the page to
the left edge of the rectangular region. The leftmost character is character 1.
right
Number that represents the distance, measured in characters, from the left edge of the page to
the right edge of the rectangular region.
verticalOffset
Number that represents the current vertical position, measured in lines.
regionHeight
Number that represents the total height of the region, measured in lines.
Setting the regionHeight to 0 instructs the DataMapper to extract all lines starting from the
given position until the end of the record.
Specifying an extraction height that is longer than the number of remaining lines results in a
"step out of bound" error message.
separator
String inserted between all lines returned from the region. If you don't want anything to be
inserted between the lines, specify an empty string ("").
Tip
l "<br/>" is a very handy string to use as a separator. When the extracted data is
inserted in a Designer template, "<br/>" will be interpreted as a line break, because
Page 415