StrongForth.f Facility Glossary


AT-XY ( UNSIGNED UNSIGNED -- )

Position the cursor of the user output device at the column specified by the first UNSIGNED and the row specified by the second UNSIGNED. The next character to be displayed will appear at this position. The upper left corner of the user output device is column zero, row zero. An ambiguous condition exists if the first UNSIGNED is not less than the number of columns, or if the second UNSIGNED is not less than the number of rows of the user output device.


EKEY ( -- UNSIGNED )

Receive one keyboard event UNSIGNED. The encoding of keyboard events is implementation defined.


EKEY>CHAR ( UNSIGNED -- 1ST FLAG )

If the keyboard event UNSIGNED corresponds to a character IN the implementation-defined character set, return that character as 1ST and TRUE as FLAG. Otherwise, 1ST is equal to UNSIGNED and FLAG is FALSE.


EKEY? ( -- FLAG )

If a keyboard event is available, return TRUE as FLAG. Otherwise return FALSE as FLAG. The event will be returned by the next execution of EKEY. After EKEY? returns with a value of TRUE, subsequent executions of EKEY? prior to the execution of KEY, KEY? or EKEY also return TRUE, referring to the same event.


EMIT? ( -- FLAG )

FLAG is true if the user output device is ready to accept data and the execution of EMIT in place of EMIT? would not have suffered an indefinite delay. If the device status is indeterminate, FLAG is TRUE.


KEY? ( -- FLAG )

If a character is available, return TRUE as FLAG. Otherwise, return FALSE as FLAG. If non-character keyboard events are available before the first valid character, they are discarded and are subsequently unavailable. The character shall be returned by the next execution of KEY.

After KEY? returns with a value of TRUE, subsequent executions of KEY? prior to the execution of KEY or EKEY also return TRUE, without discarding keyboard events.


MS ( UNSIGNED -- )

Wait at least UNSIGNED milliseconds.

Note: The actual length and variability of the time period depends upon the implementation-defined resolution of the system clock and upon other system and computer characteristics.


PAGE ( -- )

Move to another page for output. Actual function depends on the output device. On a terminal, PAGE clears the screen and resets the cursor position to the upper left corner. On a printer, PAGE performs a form feed.


TIME&DATE ( -- UNSIGNED UNSIGNED UNSIGNED UNSIGNED UNSIGNED UNSIGNED )

Return the current time and date represented by six unsigned numbers: second (0 to 59), minute (0 to 59), hour (0 to 23), day (1 to 31), month (1 to 12), year (e.g., 2007). The year in on top of the stack.


Dr. Stephan Becher - January 30th, 2009