Crestron simpl plus language ref 사용자 설명서

Crestron SIMPL+

®

Software 

z 165

ReadLongIntegerArray

SIGNED_INTEGER ReadLongIntegerArray ( INTEGER 

file_handle, 

LONG_INTEGER ilArray[m][n] )

Reads the array from a file starting at the current file position. Two bytes are read, 
most significant first containing the row dimension of the array, then two more bytes 
are read, containing the column dimension of the array. Then each long integer is read 
as a four byte quantity, most significant byte first. The integers are stored in row-
major order, e.g. all the elements of row 0 first, then the elements of row 1, etc. Note 
that there is one more row and one more column than the dimensions that are read, 
because there is a row 0 and a column 0. Refer to the section entitled “Reading and 
Writing Data to a File” on page 

 for a discussion of when to use this function and 

when to use the related functions: FileRead, ReadInteger, ReadString, ReadStructure, 
ReadSignedInteger, ReadLongInteger, ReadLongSignedInteger, ReadIntegerArray, 
ReadSignedIntegerArray, ReadLongIntegerArray, ReadLongSignedIntegerArray, 
ReadStringArray.

An error occurs if the array is not long enough to hold the data.

FILE_HANDLE specifies the file handle of the previously opened file (from 
FileOpen). 

ilArray is the array whose values are read. 

Number of bytes read from file.  If the return value is negative, it is an error code.

NOTE: Input and Output variables of any kind are not allowed in the file read 
functions.