Q33489: QB 4.00b UPDATE.DOC: Adds SLEEP Statement to Suspend
Article: Q33489 Product(s): See article Version(s): 4.00 4.00b 4.50 Operating System(s): MS-DOS Keyword(s): ENDUSER | B_BasicCom | mspl13_basic Last Modified: 16-DEC-1989 The following information was taken from the QuickBASIC Version 4.00b UPDATE.DOC file. It describes features that have been added since Microsoft QuickBASIC Version 4.00 was released. This information applies to Microsoft QuickBASIC Versions 4.00b and 4.50 for MS-DOS, to Microsoft BASIC Compiler Versions 6.00 6.00b, and to Microsoft BASIC PDS Version 7.00 for MS-DOS and MS OS/2. New Statement: SLEEP -------------------- Action: Suspends the execution of a BASIC program Syntax: SLEEP <seconds> Remarks: In this syntax the optional parameter <seconds> determines how many seconds to suspend the program. SLEEP suspends a QuickBASIC program until one of the following three events occurs: 1. The time period specified in the SLEEP statement has elapsed. 2. A key is pressed. 3. An enabled QuickBASIC event occurs. A QuickBASIC event is one that you can trap with an ON <event> statement such as ON COM or ON KEY. Note that a QuickBASIC event does not interrupt the suspension caused by SLEEP unless its trap is active when the event occurs. That is, the trap must have been set up with an ON <event> statement, turned on with an <event> ON statement, and not disabled with <event> OFF or <event> STOP. Note, too, that SLEEP responds only to actual keystrokes that occur after the SLEEP statement executes; SLEEP ignores characters that were stored in the keyboard buffer before the SLEEP statement executes. If you execute SLEEP with a time period of 0 (zero), or without specifying any time period, the program is suspended for an indefinite period. In this case, only a keystroke or QuickBASIC event can interrupt the suspension. Example: The following program suspends its execution for 20 seconds. Because the sample program has no ON EVENT statement, the only way to interrupt its suspension prior to the end of the 20-second delay is by pressing a key. PRINT "Taking a twenty-second timeout..." SLEEP 20 PRINT "Play ball!"
THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.
Copyright Microsoft Corporation 1986-2002.