This function retrieves the digital state string associated with the passed code. The passed code may be positive or negative. A null string is returned if the code is out of range.

C format

int32 pipt_digstate(

int32 digcode,

char PIPTR * digstate,

int32 len );



System error




Digital state code out of range


digcode (passed)

Digital state code

digstring (returned)

Digital state string

len (passed)

Length of the digital state string buffer

Usage Notes

The digital state string buffer length should be at least 13 characters long to avoid truncation. PI 2 Servers may return up to 12 characters and PI3 systems may return up to 79 characters.

Enabling Operational Intelligence