DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_copy_attributes - copy attributes from a source object to a destination object.

LIBRARY CALL

int
kdms_copy_attributes(
   kobject object1,
   kobject object2,
   char   *segment,
   kvalist)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise.

DESCRIPTION

This function is used to copy multiple attributes given a variable argument list containing a list attributes to copy.

Data Services manages two versions of some of the attributes associated with each object. These attributes are the size and data type. Internally, the two versions of these attributes are referred to as the physical attribute and the presentation attribute. Typically, the programmer has access to only the presentation versions of these attributes. The physical attributes are set indirectly depending on the setting of KPDS_VALUE_COUPLING. See kpds_get_data for a description of how the presentation and physical attributes affect interaction with the data object.

Other attributes are classified as either shared or unshared. Shared attributes are stored at the physical layer of the attribute, and thus can be shared by multiple references of the data object (see kpds_reference_object for more information about references). Unshared attributes, on the other hand, can only be used by the local object (see kpds_query_attribute for information on how to determine whether an attribute is shared or unshared).

This function accepts a source object, a destination object, and an attribute name. If the attribute exists in the source object, then it will be copied to the destination object. If the attribute does not exist in the source object, then an error condition is returned.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kdataman/src/attributes.c

SEE ALSO

kdataman(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.