# 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

- HB_IDLEADD()
- HB_IDLEDEL()