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 node in the XML, regardless of its level in the hierarchy; the next node may be a child element, a sibling node, or a node that is higher in the XML hierarchy than the current node.
• 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.