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.