xHarbour Reference Documentation > Function Reference

HB_ArrayId()

Returns a unique identifier for an array or an object variable.

Syntax

HB_ArrayId( <aArray>|<oObject> ) --> pID

Arguments

<aArray>

This is an array to retrieve a unique identifier for.

<oObject>

Alternatively, an object can be passedThis is an array to retrieve a unique identifier for.

Return

The function returns a pointer value (Valtype()=="P") of the passed array or object. If neither an array nor an object is passed, a null pointer is returned.

Description

Function HB_ArrayID() is provided for debug purposes and returns a unique value for the passed array or object. If two variables hold arrays or objects, and HB_ArrayId() returns the same value for both variables, they reference the same array or object.

Note:  the returned identifier is only valid during one program invocation. It cannot be used for identifying persistent data between multiple program invocations.

Info

See also:	Array(), HBObject(), HB_ThisArray()
Category:	Array functions , Debug functions , Object functions , xHarbour extensions
Source:	vm\arrayshb.c
LIB:	xhb.lib
DLL:	xhbdll.dll