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

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