DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_create_object - create a temporary data object.

LIBRARY CALL

kobject kpds_create_object(void)

INPUT

none

OUTPUT

none

RETURN VALUE

kobject on success, KOBJECT_INVALID upon failure

DESCRIPTION

This function is used to instantiate a data object (kobject) when it will only be used for temporary storage of information. If you are intending to process an object that already exists as a file or transport (input), or you are planning on saving the kobject to a file or transport (output), then the appropriate routines to use are kpds_open_input_object, kpds_open_output_object, or kpds_open_object.

This function creates an instance of a data object that will have associated with it a temporary transport that will be used for buffering large amounts of data. This temporary transport will be automatically removed when the process terminates. There is no way to rename the temporary file or replace the temporary file with a permanent one.

The kpds_create_object function call creates what is essentially a "blank" object. That is, the object will initially have no data and all attributes will be initialized to default values or to an initialized state. The default values for attributes are described in the Khoros 2.0 Programming Services Volume 2 Manual.

An object that is created with this function call behaves similarly to an output object that is created with the kpds_open_output_object function call, i.e. the object initially has no data or attributes. Thus, it is necessary to create the location, map, mask, time and/or value data and initialize attributes such as size and datatype prior to using the object.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/kappserv/kpolymorphic.h

SEE ALSO

kappserv(3)

COPYRIGHT

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