PropertyHandle :: Duplicate - Duplicate instance
You can use duplicate to create a new version of the selected instance in the same collection.
Duplicate should be used only, if the instance to be copied has no shared base instances or if all shared base instances are identified by the selected sort key for the instance. If this is not the case the system tries to create appropriate base instances with referring to the original base instance except base instances identified by __AUTOIDENT or __IDENTITY, i.e. Duplicate() will not copy automatic keys but creates new base instances with new keys.
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.
Implementation details
- ident_key
- Ident key value
The key is provided in the internal key format. When necessary the key value can be converted from a string into the internal format using the StringToKey() function.
- replopt
- Replace option
Replace options can be passed in order to control the behavior of copy functions.
Default: REPL_none