moveToNext()

Moves the position of the pointer in the source data file to the next line, row or node. The behavior and arguments are different for each emulation type: text, PDF, tabular (CSV), or XML.

This is a method of the steps object (see steps).

moveToNext(scope)

Moves the current position in a text file or XML file to the next instance of scope. What scope represents depends on the emulation type: text or XML.

Text

scope

Number that may be set to:

  • 0 or steps.MOVELINES: the current position is set to the next line.
  • 1 or steps.MOVEDELIMITERS: the current position is set to the next delimiter (as defined in the Input Data settings).
  • 2 (next line with content): the current position is set to the next line that contains any text.
Example

The following line of code moves the current position to the next line that contains any text.

steps.moveToNext(2);

XML

scope

Number that may be set to:

  • 0 or steps.MOVENODE: the current position is set to the next parent node in the XML hierarchy.
  • 1 or steps.MOVESIBLING: the current position is set to the next sibling node in the XML hierarchy.

moveToNext(left, right)

Moves the current position in a PDF file to the next line that contains any text, the search for text being contained within the left and right parameters, expressed in millimeters.

left

Double that represents the left edge (in millimeters) of the text to find.

right

Double that represents the right edge (in millimeters) of the text to find.

moveToNext()

Moves the current position in a CSV file to the next row, relative to the current position.