Skip to content

CONVERT_OBJ

CONVERT_OBJ converts an object from its current class into another class, using a customized conversion function.

Syntax

leo-grammar
CC "Core" CONVERT_OBJ objid:id
    [ tclassid:idValue| tclassname:strValue ] objname:strValue .
#-->RESULT ecode:intValue tobjid:id
CC "Core" CONVERT_OBJ objid:id
    [ tclassid:idValue| tclassname:strValue ] objname:strValue .
#-->RESULT ecode:intValue tobjid:id

Parameters

  • objid (idValue) -
  • tclassid (idValue) -
  • tclassname (strValue) -
  • objname (strValue) -

Returns

  • ecode (intValue) - Contains the error code or is 0 in case of success.
  • tobjid (idValue) -

Details

With execution of this command the related conversion function is called for the object specified with objid. The target class can be specified by ID (tclassid) or name (tclassname). Conversion functions are customized in "Conversion" class attributes. See see "Customizing Reference\Class Attributes\Conversion..." for details.
The conversion function creates a new object and deletes the existing one. The return value tobjid is the ID of the new object.

See Also

Examples

asc

SET objid:(VAL objids)
CC "Core" CONVERT_OBJ objid:(objid) tclassname:"Activity"

SET objid:(VAL objids)
CC "Core" CONVERT_OBJ objid:(objid) tclassname:"Activity"

Versions and Changes

Available since ADOxx 1.3