Table of Contents
Advertisement
Crestron SIMPL+
Language Reference Guide - DOC. 5797G
®
ReadSignedLongIntegerArray
Name:
ReadSignedLongIntegerArray
Syntax:
SIGNED_INTEGER ReadSignedLongIntegerArray ( INTEGER
file_handle,
SIGNED_LONG_INTEGER sliArray[m][n] )
Description:
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 signed 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
and when to use the related functions: FileRead, ReadInteger, ReadString,
ReadStructure, ReadSignedInteger, ReadLongInteger, ReadLongSignedInteger,
ReadIntegerArray, ReadSignedIntegerArray, ReadLongIntegerArray,
ReadLongSignedIntegerArray, ReadStringArray.
NOTE: Input and Output variables of any kind are not allowed in the file read
functions.
Parameters:
FILE_HANDLE specifies the file handle of the previously opened file (from
FileOpen).
SLIARRAY is the array whose values are read.
Return Value:
Number of bytes read from file. If the return value is negative, it is an error code.
118
for a discussion of when to use this function
Software
®
SIMPL+
173
Advertisement
Table of Contents
