DATASERV (koldgeom) functions


LIBRARY ROUTINE

kgeom_create_object - create a temporary data object.

LIBRARY CALL

kobject kgeom_create_object(
   void)

INPUT

none

OUTPUT

none

RETURN VALUE

kobject on success, KOBJECT_INVALID on 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 object to a file or transport (output), then the appropriate routines to use are kgeom_open_input_object(), kgeom_open_output_object(), or kgeom_open_object().

This function call creates what is essentially an empty object. That is, the object will initially have no data and all global attributes will be initialized to default values. If a default is not appropriate, then the attribute will be uninitialized. An object that is created with this function call behaves similarly to an output object that is created with the kgeom_open_output_object() function call.

This simple example illustrates how a data object would be created.

kobject obj;

obj = kgeom_create_object();

For large data sets, a temporary transport will be created in order to buffer the data out of memory. This temporary transport will be automatically removed when the process terminates.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/koldgeom/src/geometry.c

SEE ALSO

koldgeom(3)

COPYRIGHT

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