DATASERV (kapputils) library


LIBRARY NAME

kapputils - library of useful application level routines

DESCRIPTION

The kapputils library contains routines that make work at the application level (kroutines in the DATAMANIP toolbox, for example) easier and more productive. Use of these routines (particularly the KCALL macro) can significantly improve productivity and robustness.

The KCALL macro calls the subroutine or expression given as it's argument and checks the return value from that subroutine or expression. If the value of the return or expression is zero, then KCALL automatically calls lkcall_free() to release memory resources and exits the code containing the KCALL with a zero value. KCALL also handles printing out diagnostics and debugging information. While KCALL does expand the generated code somewhat, it's use makes programming to the standard API easier to deal with and easier to debug.

LIST OF LIBRARY FUNCTIONS

kapu_append
combine source data objects into single destination object
kapu_exprn_generate
expression based data generation
kapu_exprn_function
object expression based generation
kapu_inset
inset source object 2 into source object 1
kcall_analyze
analyze the source code text and print appropriate error messages.
lkcall_free
go through a list of objects and free them using the necesssary routines, typically kfree_and_NULL() or kpds_close_object().
kapu_mask_ops
perform AND, OR, or XOR on data object masks
kapu_upgrade_objects
check objects for value, map, and mask data, and set up for polymorphic processing
kapu_scale_data
scales the data
kapu_minmax
Obtains minimum and maximum of segment
KCALL
wrapper to simplify the use of dataservices and other common calls in a kroutine library routine

ADDITIONAL INFORMATION

LOCATION OF SOURCE FILES

$DATASERV/objects/library/kapputils/src

LOCATION OF PUBLIC INCLUDE FILE

$DATASERV/include/kapputils/kapputils.h

YOU MUST INCLUDE

#include <dataserv.h>

SEE ALSO

SEE MANUAL

COPYRIGHT

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