DATAMANIP (ksegops) functions


LIBRARY ROUTINE

lkinsertseg - insert segment(s) from one object into another

LIBRARY CALL

int 
lkinsertseg(
   kobject source_object1,
   kobject source_object2,
   char   *segment_list,
   kobject destination_object)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

This routine will insert a segment(s) specified by segment_list from source_object1 into source_obj2 and return the resulting object in destination_object. Each segment's attributes and data will be copied into the destination_object. If segment_list is NULL it will copy all the segments in the object. The segment_list is a string that contains each segment name separated by space(s).

lkinsertseg(source_object1, source_object2, "segment1 segment2", destination_object);

If source_object2 is not NULL it will be copied using kdms_copy_object() into the destination_object then the segment(s) inserted. If source_object2 is NULL, the segment(s) will be inserted into the destination_object directly. This is the same as calling lkcpseg() as follows:

lkcpseg(source_object1, "segment1 segment2", destination_object);

This routine will actually call lkcpseg() to insert the segment source_obj2 to the destination_object.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATAMANIP/objects/library/ksegops/src/lkinsertseg.c

SEE ALSO

ksegops(3)

COPYRIGHT

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