_stdinp.pub Utility - Standard Input

Syntax

call "_stdinp.pub",row,column,prompt,variable,
fillvalue,length,ctlval,flags{,helpfile,helptext}

Description

The _stdinp.pub utility is a standard input routine. It is called with the row and column for the input field. If called with text in the prompt field, the prompt is displayed, and the input follows the prompt. If the variable field contains data, then it is used as the default for the input field. The fillvalue field is a character used to fill any blank spaces in the input field following the prompt. The length field is the maximum length for the input field. The ctlval field is set to emulate the CTL variable, and the same values are returned. Refer to CTL for the actual values. The flags field has the following options:

Character

Function

b

Display the prompt in background.

r

Ring the bell for input.

u

All input is in upper case.

a

Auto CR when the end of the input field is reached.

t

Use a one minute timeout on input.

n

The only valid input is 0,1,2,3,4,5,6,7,8,9,.,+,-

s

Save original edit and function key list and restore them on exit.

The helpfile and helptext fields are optional. If they are present and a ^Y is pressed during input, then _help.pub will be called.

Editing Keys

Key

Function

Left, BS or ^H

Move left one character.

Right or ^L

Move right one character.

Tab or ^I

Move right to next tab stop.

Backtab or ^B

Move left to previous tab stop.

INS or ^T

Insert one character.

DEL or ^X

Delete one character.

^A

System call.

^Y

Call help.

^Z

Clear to end of field.

NULL

Call the calculator.

ESC

Restore line to default.

CR

Exit.

Related Files/Programs

_calc

_help.pub

_scall.pub

See Also

Alphabetical Utilities

Functional Listing of Utilities