| GT | Index Level | HUSH |
| Syntax |
HEADING string.expression
HEADING "{{text} {'options'}...}" |
| Category | BASIC |
| Type | Statement |
| Description |
designates a text string composed of literals and special options to output at the top of each page.
The "heading" expression is any valid literal string, string expression, or variable. A literal string must be enclosed in either double-quotes (") or backslahes (\) since "heading" options must be enclosed within single quotes, to distinguish them from text. Multiple options may be enclosed in the same set of single quotes. The "heading" may be changed by a new "heading" statement, and the new "heading" is output at the beginning of the next page. The very first time the "heading" is activated, it is output directly on the screen. The "page" statement is used to force pagination. The "system" function maintains line and page counters while "heading" and "footing" are active. |
| Options | * see "options: heading". |
| See Also | CRT PAGE statements & functions break-on \ options: heading FOOTING roll-on PRINTER SYSTEM |
| Example |
heading "'lc'page 'pn' printed at 'tlc' this end into shredder first.'l'"
page 1 printed at 10:22:30 29 feb 1992 this end into shredder first head = \'c'this is a heading'l'\ heading head In this example, the heading option string is assigned to a variable ("head") and subsequently assigned as the heading. |
| Warnings |
There is a 2400 character limit to heading strings.
Under normal circumstances, a heading statement executed when there is another heading active will not cause any display until the next page. However, R83 and D3 will redisplay the heading immediately if the current page number is 0. It is illegal to mix heading/footing statements with direct cursor addressing commands. |
| Compatibility | D3 7.0 AP AP 6.1 R83 |
| GT | Index Level | HUSH |