StrongForth Facility Glossary


(GET-DATE) ( -- UNSIGNED UNSIGNED UNSIGNED UNSIGNED )

Get the current DOS system date. The first UNSIGNED is the day of the month (1 to 31). The second UNSIGNED is the month (1 to 12). The third UNSIGNED is the year (1980 to 2099). The fourth UNSIGNED indicates the day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday).

(GET-DATE) corresponds to DOS interrupt 21 (hex), function 2A (hex).


(GET-TIME) ( -- UNSIGNED UNSIGNED UNSIGNED UNSIGNED )

Get the current DOS system time. The first UNSIGNED is the number ot centiseconds (0 to 99). The second UNSIGNED is the seconds (0 to 99). The third UNSIGNED is the minutes (0 to 59). The fourth UNSIGNED is the hours (0 to 23).

(GET-TIME) corresponds to DOS interrupt 21 (hex), function 2C (hex).


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 from the user input device.


EKEY>CHAR ( UNSIGNED -- 1ST FLAG )

If the keyboard event UNSIGNED corresponds to a character, return its ASCII value as 1ST and TRUE as FLAG. Otherwise, 1ST is equal to UNSIGNED and FLAG is FALSE.


EKEY? ( -- FLAG )

FLAG is TRUE if and only if a character is available from the user input device. The character will be returned by the next execution of KEY or EKEY. After EKEY? returns with a value of TRUE, subsequent executions of KEY? or EKEY? prior to the execution of KEY or EKEY also return true, without discarding keyboard events.

Note: The semantics of EKEY? is identical to the semantics of KEY?.


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.


HOME ( -- )

Position the cursor of the user output device at upper left corner of the user output device. The next character to be displayed will appear at this position.


KEY? ( -- FLAG )

FLAG is TRUE if and only if a character is available from the user input device. The character will be returned by the next execution of KEY or EKEY. After KEY? returns with a value of TRUE, subsequent executions of KEY? or EKEY? prior to the execution of KEY or EKEY also return true, without discarding keyboard events.


MS ( UNSIGNED -- )

Wait at least UNSIGNED milliseconds.


PAGE ( -- )

Clear the screen and reset the cursor position to the upper left corner.


TICKS ( -- UNSIGNED-DOUBLE )

UNSIGNED-DOUBLE is the value of the system timer, which is incremented 18.2 times per second.


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 - February 21st, 2007