Skip STATEMENT

PURPOSE:  The SKIP statement causes blank lines to appear in the report output.

SYNTAX

SKIP [ON n] {ae; TO ae; TO TOP} [HUSH] [IF; UNLESS clause] [iterate clause]

n

is a number or declared field that gives the report number to which the statement applies.

ae

is any arithmetic expression or number.  Used alone, it advances the report ae lines, but not beyond the current page.

TO ae

advances to line ae of the current page.

TO TOP

advances to the bottom of the print region, and causes execution of the FOOTINGS section, @BOTTOM_MARGIN, @PAGE_DIVIDER, @TOP_MARGIN, and HEADINGS section for the next page.

Example

Example 1 instructs ACCENT R to skip five lines.

SKIP 5

Example 2 instructs ACCENT R to skip to line 33 of the current report page.  If the current line is greater than 33, it will act as a SKIP TO TOP.

SKIP TO 33

Example 3 instructs ACCENT R to skip to the next page if the current line number on the report page is greater than 60.

SKIP TO TOP IF @LINE > 60

Example 4 instructs ACCENT R to skip to the next page but don’t print the headings

TURN HEADINGS OFF
SKIP TO TOP

NOTES:  If either SKIP ae or SKIP TO ae attempts to advance past the print region, it will instead perform as SKIP TO TOP.

A SKIP statement, without HUSH, IF; UNLESS clause, or iterate options, can be included in the PRINT statement.

SEE ALSO:  PRINT Statement and TURN Statement