HB_IdleState()

Evaluates a single background task and calls the garbage collector.

Syntax

HB_IDLESTATE()

Arguments

None

Returns

NIL

Description

HB_IDLESTATE() requests the garbage collection and executes a single background task defined by the codeblock passed with HB_IDLEADD() function. Every call to this function evaluates a different task in the order of task creation. There are no arguments passed during a codeblock evaluation.

This function can be safely called even if there are no background tasks defined.
Examples
      nTask1 := HB_IDLEADD( {|| SayTime()} )
      nTask2 := HB_IDLEADD( {|| SaveScreen()} )
      DO WHILE( !bFinished )
        bFinished :=DOSomethingVeryImportant()
        HB_IdleState()
      ENDDO
      cbAction := HB_IDLEDEL( nTask1 )
      HB_IDLEDEL( nTask2 )
Status

Ready

Compliance

Harbour extension similar to FT_IAMIDLE() function available in NanForum library.

Platforms

All

Files

source/rtl/idle.c

See Also