WaitPeriod()

WaitPeriod()

Pauses a specified time in increments of 1/100 seconds

Syntax

      WaitPeriod( [<nDelay>] ) --> lNotElapsed

Arguments

<nDelay> Designates the waiting period at initialization in 1/100ths of seconds. Values from 1 to 8, 640, 000 (one day) are possible.

Returns

WaitPeriod() returns .T. , if the time span designated at initialization has not elapsed.

Description

This function sets a time span for a xHarbour DO WHILE loop to run. The function must initialize prior to the loop, since you must specify the <nDelay> parameter in 1/100th seconds. Subsequently, the function can be implemented without a parameter for additional loop conditions. It returns .T., as long as the designated time span has not yet run out.

Note

The function notes the status of the internal timer at initialization. From that point on, the initialization should always precede the respective DO WHILE; otherwise, the time delay is incorrect. The passing of midnight (the time resets to the 0 value) is taken into account.

Examples

      Run a loop for 5 seconds:

      WaitPeriod( 500 )             // Initialization, 5 seconds
      DO WHILE <cond1> .AND. <cond2> .AND. WaitPeriod()
         *...
      ENDDO

Compliance

WaitPeriod() is Clipper Tools compatible.

Platforms

All

Files

Source is dattime3.c, library is libct.

Advertisements

2 responses to “WaitPeriod()

  1. Pingback: Harbour All Functions – W | Viva Clipper !

  2. Pingback: Harbour Date & Time Functions | Viva Clipper !

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s