^I

Access data as integer

WTSupported in traditional Synergy on Windows

WNSupported in Synergy .NET on Windows

USupported on UNIX

VSupported on OpenVMS

^I(expression)

Arguments

expression

An expression to access as integer. (a or n)

Discussion

^I is a casting function that accesses data as an integer data type.

^I does not convert expression to an integer value; the data itself remains unchanged. Only the data type is changed for the reference. (If you need to convert an expression to an integer value, use the %INTEGER function.)

Any time you cast a data area as an integer, if the high-order bit is set, you will end up with a negative number.

Examples

The following example retrieves the character terminating the READS statement as an alpha character and passes the character as an i1 value to the subroutine sub.

record 
    rec         ,a80
    size        ,i2
    trm         ,a1
proc 
    reads(TTCHN, rec)
    xcall rstat(size, trm)
    xcall sub(rec, size, ^i(trm))
    .
    . 
    . 
end