%CNV_PI
Convert portable integer data to native form
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
native = %CNV_PI(portable_int)
Return value
native
The converted data in native form. (i)
Arguments
portable_int
The portable integer field to convert. (a)
Discussion
%CNV_PI converts a portable integer created by a previous %CNV_IP intrinsic function back to native form.
When you use the integer data type, your data files are not portable between big-endian and little-endian machines. (If you don’t know what endian type your machine is, see Endian types) Once you’ve used the %CNV_IP intrinsic function to convert your data to portable form and moved it to another machine, you can use %CNV_PI to convert your data back to native form.
For integer data in ISAM files on Windows and UNIX, we recommend using the portable integer specification, I=pos:len (or PORT_INT pos:len in XDL form). |
Examples
The following routine reads a portable integer from a file and returns it as a native integer.
function rd_portable ch ,n ;Open channel size ,n ;Size of integer record p_dat ,a8 ;Portable integer data int ,i4 proc gets(ch, p_dat(1:size)) ;Read portable data from file int = %cnv_pi(p_dat(1:size)) ; convert back to integer freturn (int) ; and return it endfunction