FORMS

Process ASCII control codes

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
FORMS(channel, control_code)

Arguments

channel

The channel of the device where the control values should be sent. (n)

control_code

An expression whose result is one of the following ASCII control values to be processed: (n)

0 = Transmit a form feed.

19999 = Transmit a specified number of new line controls.

‑1 = Transmit a vertical tab.

‑2 = Transmit a ctrl+n.

‑3 = Transmit a new line.

Discussion

The FORMS statement processes special ASCII control codes. It is most commonly used to control vertical alignment on line printers. Control values of less than ‑3 cause no action, while numbers greater than 9999 generate an “Arithmetic operand exceeds maximum size” error ($ERR_BIGNUM).

Examples

forms(TTCHN, 0)                 ;Transmits one form feed
forms(TTCHN, -1)                ;Transmits one vertical tab
forms(TTCHN, 15)                ;Transmits 15 new lines