%HBJToStr function

Function

The function returns the name of the D2000 system object specified by its unique identifier (HOBJ).

Declaration

TEXT %HBJToStr(
   HBJ in objID
 )

Parameters

objID

Value of HBJ or INT types.

Description

The function sends a query to the D2000 Server process to detect the name of the D2000 system object defined by the parameter objID. If the object doesn't exist or the parameter is an invalid value, the function returns invalid value.

Example

INT _hbj
 TEXT _name
 
 ; HOBJ of the object Sec
 _hbj := %StrToHBJ("Sec")
 
 _name := %HBJToStr(_hbj)    ; variable _name will contain the value of Sec
 _name := %HBJToStr(Sec\HBJ) ; variable _name will contain the value of Sec, too
 
 ; object probably doesn't exist => _hbj is invalid value
 _hbj := %StrToHBJ("qwerty")