Avaliação do Usuário

Estrela inativaEstrela inativaEstrela inativaEstrela inativaEstrela inativa
 

hb_gcItemRef()

 

Marks the memory to prevent deallocation by the garbage collector.

 

Syntax

 

void hb_gcItemRef( PHB_ITEM pItem );

 

Argument(s)

 

<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

 

Unknown 'STATUS' code: 'C'

 

Compliance

 

This is Harbour specific

 

Platform(s)

 

This is available on all platforms

 

See also

hb_gcAlloc(), hb_gcFree()