integer_to_obj ( : Objects : SurrogateTuple : )

Convert a ``integer number'' into an iconic object.

integer_to_obj is the inverse operator to obj_to_integer. All surrogates of objects passed in SurrogateTuple are stored as objects. In contrast to obj_to_integer, the objects are duplicated. integer_to_obj is intended especially for use in HORUS/C, because iconic objects and control parameters are treated differently in C.


Attention

The objects are duplicated in the database.


Parameters

Objects (output_object)
object-array -> object
Created objects.

SurrogateTuple (input_control)
integer-array -> integer
Tuple of object surrogates.
Default value: 1


Result

integer_to_obj returns TRUE if all parameters are correct, i.e., if they are valid object keys. If the input is empty the behaviour can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.


See also

obj_to_integer



Copyright © 1996-1997 MVTec Software GmbH