Table of Contents
Advertisement
Crestron SIMPL+
Language Reference Guide - DOC. 5797G
®
WriteSignedLongIntegerArray
Name:
WriteSignedLongIntegerArray
Syntax:
SIGNED_INTEGER WriteSignedLongIntegerArray ( INTEGER
file_handle,
SIGNED_LONG_INTEGER sliArray[m][n] )
Description:
Writes the array from a file starting at the current file position. Two bytes are written,
most significant first containing the row dimension of the array, then two more bytes
are written, containing the column dimension of the array. Then each signed long
integer is written 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 written, because there is a row 0 and a column 0. Refer to the section entitled
"Reading and Writing Data to a File" on page
function and when to use the related functions: FileWrite, WriteInteger, WriteString,
WriteStructure, WriteSignedInteger, WriteLongInteger, WriteLongSignedInteger,
WriteIntegerArray, WriteSignedIntegerArray, WriteLongIntegerArray,
WriteLongSignedIntegerArray, WriteStringArray.
NOTE: Input and Output variables of any kind are not allowed in the file reading and
writing functions, just internal variables.
Use ReadSignedLongIntegerArray to read this.
Parameters:
FILE_HANDLE specifies the file handle of the previously opened file (from
FileOpen).
SLIARRAY is the array whose values are written.
Return Value:
Number of bytes written to the file. If the return value is negative, it is an error code.
Software
118
for a discussion of when to use this
SIMPL+
®
197
Advertisement
Table of Contents
