0LASubrUtilSleepWithTimer < Main

Tags: view all tags
---+ .UTIL SLEEP WITH TIMER

_This subroutine pauses for the specified number of seconds and displays a countdown timer._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;seconds&gt;                  FIELD            SHARE? N
      PASS         &lt;refresh&gt;                  FIELD            SHARE? N
      GOSUB    --- .UTIL SLEEP WITH TIMER
      *        Check for errors
      IF       --- .UTIL SLEEP WITH TIMER     NE

</pre>
---++ Description:

This subroutine pauses for the specified number of seconds and displays a countdown timer. The number of seconds must be PASSed or the subroutine will CANCEL.

&lt;seconds&gt; is the number of seconds to 'sleep' (Required). This must be an integer greater than zero. Passing zero or a negative number will immediately exit.

&lt;refresh&gt; is the frequency in seconds of how often the countdown should be updated. This parameter is optional, and if not PASSed, or is zero or negative, no countdown will be displayed. In this case, this subroutine is the same as [[0LASubrUtilSleep][.UTIL SLEEP]].

Control will not return to the calling program until the specified number of seconds has elapsed. This subroutine can be interrupted via Control-C in character mode.

---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2012-01-27
Topic revision: r1 - 2012-01-27 - JeanNeron