AAO DRAMA C++ Interface (Old style)
DRAMA C++, Depreciated, don't use for new code

◆ Find()

void SdsId::Find ( const SdsId source,
const char *const  name,
StatusType *const  status 
)
inline

Find an SDS object and make available in the current SdsId object.

This method will first clean up the SdsId object, as if the destructor were run. It then finds a new SDS object within the object represented by "source" and makes that available in the object.

The purpose of this method is for cases where an SdsId object must be set up in a different spot from where the variable is declared.

This method is meant to replace sequences where previously one would have needed to create a new object, and then use ShallowCopy() to copy its contents to another object.

If the find fails or if status is non-zero on entry, then the object will have been cleaned up and will refer to a null SDS object.

See also
SdsId::ShallowCopy @sds SdsFind()
Parameters
sourceThe object containing the object of interest
nameThe name of the SDS object of interest
statusInherited status.