company logo

DBStructDef :: CopyDirect - Copy attributes between instances

Attributes are copied from the source instance to the target instance by name. The source structure passed may differ from the target structure, since attributes are assigned by attribute names. For embedded complex attributes, CopyDirect is called recursively.

Return value:  Success ( logical  )

Implementation overview

Implementation details

  1. Copy attributes between instances
    logical DBStructDef  :: CopyDirect ( void *targinst, DBStructDef *srcedef, void *srceinst )
    • targinst - Target instance

      Instances do have the type of the referenced property handle (collection type). The instance contains a pointer to a properly structured instance area.

      You can use the !-operator or the GetData() function to check whether the instance refers to data or not.

    • srcedef - - internal feature (not documented)
    • srceinst - Source instance
  2. to list
  3. - internal feature (not documented)
    logical DBStructDef  :: CopyDirect ( void *targinst, void *srceinst, logical opt_sensi=NO )
    • targinst - Target instance

      Instances do have the type of the referenced property handle (collection type). The instance contains a pointer to a properly structured instance area.

      You can use the !-operator or the GetData() function to check whether the instance refers to data or not.

    • srceinst - Source instance
    • opt_sensi - Consider key attributes, only

      When the option is NO, all attributes are considered. In case of 1 (YES), only key component attributes are considered. In case of 2, only attributes that are not key components are considered.

      Default: NO
  4. to list