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

hb_gcItemRef()

Marks the memory to prevent deallocation by the garbage collector.
---------------------------------------------------------------------------------

 Syntax

        void hb_gcItemRef( HB_ITEM_PTR pItem );  

 Arguments

        <pItem>    The pointer to item structure that will be scanned. 
                  The passed item can be of any datatype although arrays,
                  objects  and codeblocks are scanned only. Other datatypes
                  don't require  locking so they are simply ignored.

 Returns

        Nothing.    

 Description

      The garbage collector uses hb_gcItemRef() function during  scanning
      of referenced memory pointers. This function checks the  type of
      passed item and scans recursively all other memory blocks
      referenced by this item if it is an array, an object or a codeblock.

      NOTE: This function is reserved for the garbage collector only. It
      cannot be called from the user code - calling it can cause
      unpredicted results (memory blocks referenced by the  passed item
      can be released prematurely during the closest  garbage collection).

Status

      Clipper

 Compliance

      This function is a Harbour extension

 Platforms

      All

 Files

      source/vm/garbage.c