pdcupu DEPRECATED
primary_value.r4.v = pdcupu(common_value.r4.r, pdb.s.r, error.i2.r
[,units_text.i1a.r])
This function is used to scale the value of a device expressed
in common units to a value expressed in primary units. The
function always returns a single-precision real value.
common_value data value in common units to convert
pdb Process Data Block (scaling data)
(reading and setting properties only)
(structure of type PDB_RS)
error returned status value
(OK = scaling success
DIO_xxx = scaling failure)
[units_text] returned units text (LEN_DEV_UNITS characters)
(default is NULL)
This function returns status values as follows:
converted value in primary units
This function requires the following include files:
cnsparam_h, cns_data_structs_h, clib_h, acnet_errors_h
Related functions:
pdcupu_ext, pdcupu8, pdcuud, pdcuud_ext, pdcuud8, pdpuud, pdpuud8,
pdpuud_ext, pdpucu, pdpucu_ext, pdpucu8
C/C++ usage:
char units_text[LEN_DEV_UNITS];
short error;
float primary_value;
float common_value;
PDB_RS pdb;
primary_value = pdcupu(&common_value,&pdb,&error,units_text);