Click above to get retro games delivered to your door ever month!

SHOWTIME()

Syntax:     SHOWTIME([<expN1>][,<expN2>][,<expL>][,<attr>])

Arguments:  <expN1> denote the row in which the time should be shown.
            <expN2> denote the column in which the time should be shown.
            <expL> determine whether seconds should appear in the
            time display (.F.) or not  (.T.).
            <attr> denotes the screen attribute used for the time display
            in the form "nn/nn" or "cc/cc" (e.g., "0/7" or "B/GR").

            The time display will be uninstalled by calling the function
            with no arguments.

Returns:    A character string.
            A null string is always returned.

Usage:      This function is intended to display the time permanently in a
            particular position on the screen.  SHOWTIME() is interrupt
            driven, and is capable of displaying the time optionally in the
            format hh:mm:ss or hh:mm.

Notes:      SHOWTIME() uses the interrupt system in its implementation
            SHOWTIME() must be uninstalled before leaving the Clipper
            application, so that the interrupt vectors can be restored.
            if this is not done then the system will be in an unstable
            condition, which will sooner or later lead to a crash.  The
            interrupt vector used will be restored automatically, if the
            expanded driver module is used.  The screen attribute may
            be specified either numerically or as a string in the form
            "nn/nn".

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * Show the time in line 0, column 70
            * without the seconds.

            SET SCOREBOARD OFF

            SHOWTIME(0,70,.F.)                  && Clock switched on
            ...

            SHOWTIME()                          && Clock uninstalled