SKIP Syntax Diagram

SKIP

Variants:

1. SKIP.

2. SKIP n.

3. SKIP TO LINE line.

Variant 1

SKIP.

Effect

Outputs a blank line.

Example

The statements

WRITE: 'Text 1 ......'.
SKIP.
WRITE: 'Text 2 ......'.

produce the following output:

Text 1 ......

Text 2 ......

Variant 2

SKIP n.

Effect

Outputs n blank lines.

Note

The SKIP statement is only executed if there are still enough lines on the current page. Otherwise, a new page is started (see NEW-PAGE LINE-COUNT).

At the beginning of a new page, SKIP only generates blank lines if this page is the first page of the list or if this page was explicitly requested by NEW-PAGE. Otherwise, SKIP statements are ignored at the beginning of a page.

At the end of the last list page, SKIP only generates blank lines if there is more output (WRITE, ULINE). Otherwise, SKIP statements are ignored at the end of the last page.

Variant 3

SKIP TO LINE line.

Effect

Moves the output position to the line lin. You can move up or down to any position on the current page. The current page is the page on which the next list line is normally output, i.e. the page displayed after the next new line. The line count starts at 1.

Example

The statements

REPORT TEST NO STANDARD PAGE HEADING.

DATA: LINE TYPE I VALUE 3.

WRITE 'Line 1'.
SKIP TO LINE 5.
WRITE 'Line 5'.
SKIP TO LINE ROW
WRITE 'Line 3'.

produce the following output:

Line 1

Line 3

Line 5

Note

The statement SKIP TO LINE lin is executed only if the contents of lin lie between 1 and the maximum number of lines per page (see NEW-PAGE LINE-COUNT).

Additional help

List Creation